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@ Preface 


The CONTROL DATA® Network Operating System (NOS) provides the 
capability of editing files page-by-page. The CDC® NOS Full Screen Editor 

@ (FSE) enables you to edit sequenced and unsequenced files both 
page-by-page (screen mode) and line-by-line (line mode). 


This guide explains how to access and use FSE in both line mode and screen 
mode. Examples and illustrations help you with each step. 


What You Need to Know Before Reading 
This Guide 


This guide is intended for you if you are familiar with the interactive use of 
NOS. Some knowledge of NOS file types is helpful but is not required. All 
examples use the CONTROL DATA Viking 721 terminal; knowledge of this 
terminal is helpful but not essential. For information on the interactive use of 
NOS, refer to the NOS Reference Set, Volume 1, Introduction to Interactive 
Usage. For detailed hardware descriptions of the Viking 721 terminal, refer 
to the 721-10/20/30 Hardware Reference Manual (ordering information is in 
Related Publications later in the preface). 


Conventions 


Throughout this guide, we use representations of actual keys to show you 
when you should press a key. For example, 


is Shown as just 
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Two keys appearing side by side means hold down the first key while 
pressing the second. For example, 


S 
means hold down(<) and press 


Sometimes you have to press more than one key in succession to execute a 
certain function. This is indicated with a + sign. For example, 


S 
means hold down (ad) , press , release both, and then press . 


Some function keys have labels both on the keyboard and on the screen. For 
example, the key labeled only (F1) on the keyboard, has the following screen 
label. 


me MARK 


The screen label is used in this guide. 


The keys are sometimes combined. For example, to page backward on the 
DEC VT100 terminal, you would use: 


F1 EX) + (RETURN) 


In descriptions of directives or parameters, the shortest valid abbreviations 
are underlined (usually the first letter). Parameters that must be entered 
exactly as shown are shown in UPPERCASE CHARACTERS; variable 
parameters are shown in all lowercase characters. Optional parameters are 
shown in italics. 


Anything you enter is shown in blue. 
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@ Manual Organization 


Section 1 introduces FSE and its capabilities and describes the Viking 721 
terminal and the differences between the Viking and other terminals. 
Through examples, section 2 describes the basic screen editing functions. 

& Section 3 describes the FSE command used to start FSE. Section 4 includes 
detailed descriptions of the FSE directives. Section 5 shows you a sample 
session using many of the advanced FSE functions, which are then 
described in detail in section 6. Using examples, section 7 describes how to 
use FSE as a line editor. Section 8 contains worksheets to help you figure out 
how to use FSE on terminals other than the Viking 721. 


The order in which you should read these sections depends on the mode of 
editing you want to use. If you intend to use screen editing, you should read 
the manual straight through from section | through section 7. If you intend 
to use FSE as a line editor, read section 1 followed by section 3, section 4, and 
section 7. 


Appendix A includes information on the character sets supported by FSE. 
Appendix B contains explanations of FSE diagnostic messages and how to 
recover from errors that garble your screen. Refer to appendix C for 
definitions of unfamiliar terms. Appendix D describes how to use FSE with 
CDC 722, DEC VT100, Zenith Z19, Heathkit H19, Lear Siegler ADM3A and 
ADM5, and Tektronix 4115 terminals.t Appendix E is a listing of the 
directive strings composing the various FSE functions. Appendix F describes 
the Viking 721 terminal settings needed to ensure proper operation of FSE. 


is a product of the Zenith Radio Corporation. Heathkit H19 is a product of 
the Heath Company. Lear Siegler ADM38A and ADM5 are products of the 
Lear Siegler Corporation. Tektronix 4115 is a product of the Tektronix 
Corporation. 


@ + DEC VT100 is a product of the Digital Equipment Corporation. Zenith Z19 


5 ) 
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Related Publications © 


The following Control Data publications may help you in further 

understanding NOS or the Viking 721 terminal. Also listed is a binder to 

protect your manual. All are available from Control Data sales offices and 

from Literature Distribution Services, 308 North Dale Street, St. Paul, MN @ 
55108. : 


Control Data Manual Publication Number 


NOS Version 2 Reference Set, Volume 1, 


Introduction to Interactive Usage 60459660 
NOS Version 2 Reference Set, Volume 2, 

Guide to System Usage 60459670 
NOS Version 2 Reference Set, Volume 3, 

System Commands 60459680 
NOS Screen Formatting Reference Manual 60460430 
NOS Version 2 Manual Abstracts 60485500 
Software Publications Release History 60481000 


721 Display Terminal 


Operator’s Guide/Installation Instructions 62940019 
721-10/20/30 Hardware Reference Manual 62940020 
721-21/31 Owner’s Manual 62950101 
Loose Leaf Binder, 6 in by 9 in 60086200 
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Introduction 


Terminals 


Viking 721 Terminal 
Other Terminals 


ede ee 2 Y 


Sa 2 ee  Y 


a a 7 


Introduction 1 


Using the NOS Full Screen Editor (FSE) on a video display terminal, you 
can display a page of text on the screen, move through a file page by page, 
| and make most of your changes with the touch of a key. To be used asa 
@ screen editor, FSE must first be placed in screen mode. 


If you are working on a printing terminal, you will use FSE’s other editing 
capability, line editing. In contrast to screen editing, you see only a limited 
number of lines at any one time. Line editing is also available for use on 
video display terminals. To be used as a line editor on any type of terminal, 
FSE must be placed in line mode. 


In either mode, you can edit both sequenced and unsequenced files. 


FSE Capabilities 


Using FSE, you can: 

e Create or change a file. 

e Undo changes you made to a file during your current terminal session. 
SS e Display and edit two files on one screen. 


e Search for and replace text according to the column in which the text 
appears. 


@e Move or copy parts of a file within the same file or into another file. 
e Search for and replace words. 
e Create FSE procedures using FSE directives. 


e Manipulate words, lines, and paragraphs of text with the FSE word 
processing directives. 


e Access a tutorial file and practice editing. 


These and the many other capabilities of FSE are described in detail in this 
guide. 


Revision B Introduction 1-1 


Terminals 


FSE supports almost all display terminals. First, however, it is necessary 
that the terminal type be defined to the system. Some terminals already have 
been defined by Control Data; others are defined by the site or by the user. 


Control Data has defined the following terminals. 
e CDC Viking 721. 

e CDC 722. 

e DEC VT100. 

e Zenith Z19. 

e Heathkit H19. 

e Lear Siegler ADM3SA. 

e Lear Siegler ADM5. 

e Tektronix 4115. 


For a terminal other than one of these, check if it has been defined by the 
site; if not, you may be able to define it yourself. The process is described in 
the next section under Getting Started. 
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Viking 721 Terminal 


One of the terminals already defined to the system is the Viking 721. 
Throughout this guide, examples and explanations use this terminal as a 
model for the keys and functions. 


To log in to NOS and start FSE, the Viking 721 must be set up correctly. 
Appendix F shows how the terminal should be set up; however, if your 
terminal has been used with NOS before, try using it without changing any 
of the settings. 
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Some often used keys on the Viking 721 are: 


(=) (—) 


Qo ce (?) (¢) 


x 


ey Function 


Return, carriage return, or new line. 
(—) Backspace. 

(<<) Shift. 

Shift lock. 

Tab forward. 

Tab backward. 


Cursor movement. 


D 
S 
Soe 
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© Other Terminals 


If you are using a terminal other than the Viking 721, you may have to 
substitute other keys for those used in the examples. If you have one of the 
Control Data-defined terminals listed previously, refer to appendix D, 
| Terminal Support Information, for a listing of the keys on your terminal that 
©} are equivalent to the Viking 721 keys. Section 8, Using Other Terminals, 
provides you with worksheets to record your terminal keys next to the 
corresponding Viking 721 keys. 


The following list shows typical differences between the Viking 721 and 
other terminals. 


Viking 721 Typical Equivalent 
NEXT RETURN) or 


a3 


(F1) through through or (1) through (8) 


(<>) (F1) through Shifted keys on a keypad or no equivalent keys. 


(Ss) 
The (F1) through keys are programmable function keys and are 


& described later. Many terminals require you to press (RETURN), 
NEW LINE) , or after a programmable function key. For example: 


Viking 721 Equivalent on Zenith Z19 


(F1) (F1) + (RETURN) 
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Screen Editing 2 


Getting Started 


To get started on FSE, you must be logged in to NOS. For information on 
NOS login procedures, refer to the NOS 2 Reference Set, Volume 2, Guide to 
System Usage (ordering information can be found in the preface). 


Establishing Screen Mode 


After you are logged into NOS, enter the following command to identify your 
terminal type and tell NOS that you want to be in screen editing mode 
whenever possible. 


SCREEN, model 
NOTE 


Screen editing mode remains in effect for the entire terminal session, even if 
you change editing modes while using FSE. 


If you do not enter a SCREEN command prior to starting FSE, FSE will act 
as a line editor (the default mode). Refer to section 7, Line Editing, for 
information about this function. 


model represents the name that identifies your terminal type. If you have 
one of the following terminals, use the model name shown (Control Data has 
defined the terminals to the system and assigned the model name). 


Terminal  ——ss—S——S mood ee 
Viking 721 721 

CDC 722 122 

DEC VT100 VT100 


Zenith Z19 and Heathkit H19 Z19 


Lear Siegler ADM3A ADM3A 
Lear Siegler ADM5 ADM5 
Tektronix 4115 T4115 
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For example, to establish screen mode for the Viking 721 terminal, you would 
enter: 


SCREEN, 721 


and press: 


Other terminals may have been defined to the system by the site. To 
determine if this is the case, access your site’s terminal file library (model is 
the name of a compiled and stored terminal definition file). Use the 
commands: 


GET, TERMLIB/UN=LIBRARY 
CATALOG, TERMLIB,R,U,N 


If your terminal has not been defined, you can do so using the Terminal 
Definition Utility. Enter the command: 


GET, TDUIN/UN=LIBRARY 
FSE,TDUIN 


You will get a text file containing pretyped terminal definition statements. 
Edit the file to define your terminal. You will also need to define your 
programmable function keys (these keys are described later in this section.) 
For details, refer to the NOS Screen Formatting Reference Manual (ordering 
information can be found in the preface). 
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Starting FSE 


Having established screen mode for your terminal session, you can start FSE 
and specify the name of the file you want to edit. For example, to start FSE 
and specify that you want to edit a local file named MYFILE, you would 
enter: 


FSE,MYFILE 


and press: 


If MYFILE does not already exist as a local file, it is created. Your screen 
then clears and the following appears. 
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Sample Display Screen | @ 


The following sample display screen contains a file called MYFILE, which 

will be used in the demonstrations of editing techniques that follow. It 

therefore contains intentional errors, which will be corrected later. MYFILE 

is not released with the system. If you would like to practice as you read, you & 
may want to create this file and enter the appropriate text. 
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(1) Directive Line. The line on which you enter FSE directives. To position 
the cursor at this line, press or the equivalent key for your 
terminal. 


@ (2) Message Area. The area on the right side of the directive line where FSE 
displays messages and prompts. 


(3) File Header. The file name, lines currently displayed, and total number of 
lines in the file. If the file is uppercase, the prefix Upper Case appears on 
this line. If the file is lowercase, no prefix appears. 


(4) File Text. The contents of the file. 


(5) Programmable Function Key Prompts. The labels currently assigned to 
function keys through (F8). These keys are described later in this 
section. 


(6) Cursor. Your current position in the file, where text may be entered or 
edited. 
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Sample Editing Session 


You can do most of your editing by positioning the cursor at the text to be 
changed and typing the corrections over the old text. Other editing functions 
can be performed with only the touch of a key. Using basic screen editing 
techniques, the errors in the previously introduced sample file (MYFILE) will 
now be corrected. Use this session to obtain an overview of basic screen 
editing. More advanced aspects of screen editing, including descriptions of 
the function keys and FSE directives used, appear later in the guide. In the 
sample session you will: 


@ Set screen mode. 

e Start PSE. 

e Position the cursor. 

e Type over text. 

e Insert and delete characters. 
e Insert and delete lines. 

e Page forward and backward. 


@e Move lines. 


e Copy lines. 

e Undo changes made to a file. 

e Access the FSE online HELP file. 

e Stop and restart FSE. 

e Make changes permanent. 

e Edit sequenced files. 

e Create multirecord and multifile files. 


More detailed information on function keys and FSE directives appears later 
in this guide. 
Setting Screen Mode 


After you are logged in to NOS, enter the following command to set screen ® 
mode for the Viking 721 terminal. 


SCREEN, 721 
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®& Starting FSE 


Enter the following command to start FSE and to specify that you want to 
edit file MYFILE. 


®& FSE,MYFILE 


FSE accesses file MYFILE. If MYFILE does not already exist as a local file, 
it is created. 


If MYFILE is already a permanent file but is not local, enter the following 
FSE command to start FSE and make MYFILE local. 


FSE,MYFILE,G 


The following screen appears. 
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Positioning the Cursor 


To move the cursor around on the screen, use the arrow keys. On the Viking 
721, these keys are located on the numeric keypad to the right of the main 
keyboard, and appear as: 


Gy) 
ae 


You do not have to press (<4) to use these keys and, when you hold them 
down, they automatically repeat.t 


Typing Over Text 


You can make most corrections to text by positioning the cursor at the text to 
be corrected and typing the correction over the existing text. For example, in 
the eighth line of MYFILE, you can change INGETER to INTEGER by 
positioning the cursor at the G: 


IMPLICIT INGETER (A-Z) 


and typing T. 
IMPLICIT INTETER (A-Z) 
(After you type the T, the cursor will move one character forward.) 
Then, position the cursor at the second T: 
IMPLICIT INTETER (A-Z) 
and typeG. 


IMPLICIT INTEGER (A-Z) 


+ These two characteristics of the terminal are set during terminal 
installation. If the nonvolatile memory in the terminal fails, they will no 
longer be available. Information on resetting them can be found in the 
CDC 721-21/31 Owner’s Manual (ordering information is in the preface). @ 
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@ Inserting Characters 


Position the cursor where you want to insert a character and press: 

For example, the 24th line of fileMYFILE is missing a/ following 'OUTPUT'. 
DATA OUTFILE/'OUTPUT',INPFILE/' INPUT‘ / 

To add the slash, position the cursor as follows: 
DATA OUTFILE/'OUTPUT',INPFILE/" INPUT" / 

Then press: 


FSE inserts a blank where the cursor is positioned. Type the slash into this 
blank. 


DATA OUTFILE/'OUTPUT'/, INPFILE/' INPUT ' / 


(After you type the slash, the cursor again moves one character forward.) 


@ Deleting Characters 


Position the cursor at the character you want to delete. For example, file 
MYFILE has an extra parenthesis on the 10th line. 


PARAMETER ((MSC=50) 

Position the cursor at the extra parenthesis. 
PARAMETER ((MSC=50) 

Then press: 

The result is: 


PARAMETER (MSC=5Q) 
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Inserting Lines 


The line: 
LOGICAL PARMERR 


needs to be inserted in file MYFILE between the following two lines (lines 20 
and 21). 


CHARACTER*50 PENTRY, SENTRY, TENTRY,BLANK 
DIMENSION TAB(3) 


To do this, position the cursor where you want the new line to appear. 


CHARACTER*50 PENTRY,SENTRY, TENTRY,BLANK 
DIMENSION TAB(3) 


Then press: 
cas 

FSE inserts a blank line where the cursor is positioned. 
CHARACTER*50 PENTRY,SENTRY, TENTRY,BLANK 
DIMENSION TAB(3) 


You can then type the new line over the blank. 


CHARACTER*50 PENTRY SENTRY, TENTRY ,BLANK 
LOGICAL PARMERR. 
DIMENSION TAB(3) 
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Deleting Lines 


In file MYFILE, the 12th and 14th lines both declare CHARACTER*40 COND. 


CHARACTER*40 COND 
CHARACTER*1 CO,CN 
CHARACTER*40 COND 
CHARACTER*10 SLANTS 


To delete the second of these duplicate lines, position the cursor anywhere on 
the line to be deleted. 


CHARACTER*40 COND 
CHARACTER*1 CO,CN 
CHARACTER*40 COND 
CHARACTER*10 SLANTS 


Then press: 


S) Get) 


The result is: 


CHARACTER*40 COND 
CHARACTER*1 CO,CN 
CHARACTER*10 SLANTS 


Each time you delete a line, the lines below it move up, leaving a blank line 
at the bottom of the screen. FSE will fill in these blanks with the appropriate 
lines from your file when you press: 
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Paging Forward and Backward 


Pressing: 


advances the screen display to the next page forward in the file. The bottom 
line of the page you were on carries over and reappears at the top of the new 
display. The following screen is the second page of sample file MYFILE. 


219 FSE User’s Guide Revision A 


& To see the previous page, press: 


FSE displays the previous page. 


MRKCHR 
MARK 
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Moving Lines 


In sample file MYFILE, the following group of lines needs to be moved. 


IMPLICIT INTEGER (A-Z) 

PARAMETER (PRM=1,PRMC=2,SEC=3,SECC=4, TER=5, TERC=6) 
PARAMETER (MSC=50) 

PARAMETER (MAXILEN=160,MAXSLEN=310,MAXOLEN=160) 


To do this, place the cursor at the first line of the group to be moved (line 8). 
IMPLICIT INTEGER (A-Z) 
Then press: 


a MARK 


This marks the line as the beginning of a group of lines to be moved. Then 
place the cursor at the last line of the group (line 11). 


PARAMETER (MAXILEN=160,MAXSLEN=310,MAXOLEN=160) 
Press: 
ee MARK | 


again. This marks the line as the last of the group to be moved. The entire 
block marked is highlighted as inverse video display. 


IMPLICIT INTEGER (A-Z) 
PARAMETER (PRM=1,PRMC=2,SEC=3,SECC=4,TER=5,TERC=6) 
PARAMETER (MSC=50) 


PARAMETER (MAXILEN=160 ,MAXSLEN=310 ,MAXOLEN=160) 


| (If you want to move just one line, only the first mark is needed.) 
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The block is to be relocated between lines 20 and 21. 


LOGICAL PARMERR 
DIMENSION TAB(3) 


Position the cursor anywhere on the DIMENSION TABC3) line. Then press: 
Fe (les 


The screen now appears as: 


LOGICAL PARMERR 

IMPLICIT INTEGER (A-Z) 

PARAMETER (PRM=1,PRMC=2,SEC=3,SECC=4, TER=5, TERC=6) 
PARAMETER (MSC=50) 

PARAMETER (MAXILEN=160,MAXSLEN=310,MAXOLEN=160) 
DIMENSION TAB(3) 


The lines you marked no longer exist at their old location, and are no longer 
highlighted. 


Copving Lines 


If you want to copy lines without deleting them from their previous location, 
follow the steps described for moving lines, but press: 


instead of: 


ag MOVE 
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Undoing Changes Made to a File 


Suppose at this point, you realize that the lines should not have been moved. 
Rather than marking the lines again to move them back tc their original 
position, all you need to do is press: 


me UNDO 


FSE undoes the previous operation. In this example, the lines are moved 
back to their original position. 


C 
IMPLICIT INTEGER (A-Z) 
PARAMETER (PRM=1,PRMC=2,SEC=3,SECC=4, TER=5, TERC=6) 
PARAMETER (MSC=50) 
PARAMETER (MAXILEN=160,MAXSLEN=310,MAXOLEN=160) 
CHARACTER*40 COND 


F5 (Xba will undo all the changes you made to file MYFILE during the 
current editing session in the reverse order that they were made. To undo the 
most recent change, press: 


eR UNDO, 


once. To undo the last two changes, press: 


FS [we © 


twice. You can repeat the step until the original file is restored. 


NOTE 


The UNDO command can be turned off using the SET directive (SET UNDO 
NO). For details, refer to the description of the SET directive in section 4. 
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@ Accessing Online HELP 
To access online FSE information, press: 


@ FSE splits the screen in half, with the FSE HELP file on the lower half of the 
screen. 


LOCNXT 
LOCATE 


By changing the position of the cursor, you can manipulate each half of a 
split screen separately. For example, to page forward in the HELP file 
without disturbing MYFILE, move the cursor to the HELP file text and 


press: (FWp). 


If you would like to practice, you can edit MYFILE while reading HELP. To 
return to MYFILE only, press: (BACK). 


Don’t worry if you accidentally make a change to the FSE HELP file; the 
©} change is not permanent. 
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Stopping FSE and Keturning to NOS 
To return to NOS, press: 
F6 


Any files you have edited, including changes, remain as local files, ready for 
use by compilers or other programs. The exception is a direct access file 
attached in write mode. In this case, any changes are immediately made 
permanent. 


Stopping FSE and Making Your Changes 
Permanent 


To complete your editing session and make any changes to your files 
permanent, press: 


This moves the cursor to the FSE directive line. To save the files you’ve 
edited as permanent files and to stop FSE, enter: 


QUIT REPLACE 
which is abbreviated: 
QR 


When you stop FSE, the following messages appear, informing you whether 
the changes to your file(s) are permanent. 


FILE: MYFILE (PERMANENT) 
FILE: FSEPROC (NO CHANGES) 
PILE: FSEHELP (NO CHANGES) (READ-ONLY FILE) 


The FSEPROC file is accessed every time you start FSE and is described in 
detail in section 6, Advanced FSE Functions. 


Restarting FSE 


Having stopped FSE, you can, during your current terminal session, return 
to editing a file at the exact point you left off. To do this, enter the FSE 
command without parameters. 


FSE 
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For example, suppose you finish editing MYFILE at the point shown by the 
cursor. 


dee 


You then press: 


and enter: 
aR 


stopping FSE and making your changes to the file permanent. The following 
messages appear. 


FILE: MYFILE (PERMANENT) 
FILE: FSEPROC (NO CHANGES) 
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After doing other things on NOS, you want to return to editing MYFILE. @ 
Enter: 


| ses 
You are returned to the exact point at which you left MYFILE. @ 


NOTE 


If you change your file between FSE editing sessions, be sure to specify the 
file name when you reenter FSE. For example, enter: 


FSE,MYFILE @ 


rather than 


FSE 
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© Fditing Sequenced Files 


When you create or edit a sequenced file in the BASIC or FORTRAN 
subsystem, FSE assumes the file is a numbered sequenced file. Within 
directives, you can refer to the lines by their sequence numbers, rather than 


© the numbers FSE assigns. 


If you change a sequence number by typing over it, FSE does not allow you 
to make that number less than the preceding nor greater than the following 
sequence number. If you try to do so, the sequence number is deleted. For 
example, lines 00140 through 00160 appear as: 


00140 Line 1 
00150 Line 2 
00160 Line 3 


If you type 00165 over 00150, the lines appear as: 


00140 Line 1 
Line 2 
00160 Line 3 


The same happens if you try to type a sequence number less than 00140. 


Refer to the description of the SET NUMBER directive in section 4 for more 
@ information on manipulating sequence numbers. 
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Creating Multirecord and Multifile Files 


If you want to create multirecord or multifile files, you must separate your 
records and files with marks. End-of-record (EOR) signifies the end of a 
record; end-of-file (EOF) signifies the end of a file. These marks must be 
placed on a separate line beginning in column 1. FSE will automatically 
insert an (HOR) and an (EOF) mark at the end of every edit file that you 
create (as a result, single-record files don’t require file marks, as FSE 
automatically supplies them). The following is a sample file to demonstrate 
the placement of file marks in a multirecord file. We will assume you are 
creating a file containing names and addresses. 


This is the first record.: 


This is the second record. 


Notice that you don’t need an end-of-record mark for the last record in the 
file. FSE automatically inserts both an end-of-record and an end-of-file mark 
after the last record. 
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Viking 721 Terminal 
Function Keys 


In addition to the standard ASCII character keys, like (A) and (5), FSE 
supports three types of function keys: editing, CDC standard, and 
& programmable. 


Editing Keys 


The editing keys are: 
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The editing keys usually perform their functions locally (in your terminal) 
| and instantaneously. The editing key functions are: 


Key Function 

Inserts a blank, allowing you to type in a new character. 

(SB) Inserts a blank line. 

Deletes the current character. 

(<a) Deletes the current line and moves the following lines up. 
Press: 
to fill in the lines at the bottom of the screen. 

Backspaces a single character and deletes it. When 
shifted, it deletes the current line and moves the cursor 
back to the first column. 

Moves the cursor forward to the next tab. Default tab 
settings are 1, 7, and 72. Refer to the SET directive 
description in section 4 for information on setting tabs. 

Moves the cursor backward to the immediately preceding 
tab. 

Deletes all characters from the cursor to the end of the 
line. 

| (d) Clears the entire screen; FSE then completely rewrites it. 
If you suspect the screen does not look right, rewrite it by 
entering: 


S) CLEAR + EXT) 
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& CDC Standard Function Keys 


The CDC standard function keys are: 


@ owe) | 


The CDC standard function keys perform operations that apply to nearly all 


joae 


= 
m 
m 
0 


Pa ” ow 
m = > 
x Oo re) 
aj OY [A 


Revision B 


Function 

Advances screen one page. 

Moves screen backward one page. 

Positions the current line to the top of the screen. 
Positions the current line to the bottom of the screen. 
Displays the FSE HELP file. 

Returns you to the previously edited file. 

Stops a search or replacement in progress. 
Terminates an input line. 


Moves cursor to the directive line, enabling you to enter 
directives. 


Screen Editing 
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Programmable Function Keys 


The programmable function keys can be defined to execute any of the FSE 
directives (refer to section 6, Advanced FSE Functions). The default 
functions of the programmable function keys are displayed at the bottom of 


your screen. Se 


Usually, only the F1 through F8 function key prompts are displayed. The 
default prompts and their corresponding keys are: 


COPY LAST 80COL 
wa MOVE gm 6FIRST men QUIT gem 1 32COL 


The F9 through F16 prompts can be displayed using the SET PROMPT 
directive described in section 4. The default prompts and their corresponding 
keys are: 


3 Ee COPY +5 "| 
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The lower line of the prompt indicates the unshifted key function; the upper 
line indicates the shifted key function. The function key numbers are in 
raised letters adjacent to the keys. Some of the programmable function keys 
also have labels on the key itself. Their labels are used by other applications 
and have no significance within FSE. The default functions for the Viking 
721 programmable function keys are: 


Key Description 


MRKCHR Pressed once, marks a line for future use with another 
mm MARK function. Pressed twice, marks a range of lines. If you 
accidentally mark the wrong line or line range, press: 


em UNDO 


to unmark the line or range. When shifted, 
ae MRKCHR 


marks a range of characters. 


Moves the range of lines set by the MARK function, or 
Fe Wes characters set by the MRKCHR function, to the position 
marked by the cursor. When shifted, 


ame COPY 


copies the range of lines or characters set by the MARK or 
MRKCHR functions. 


Inserts 22 blank lines at the position marked by the cursor. 
When shifted, 


ee DELB 


deletes blank lines, starting with the line the cursor 1s at, 
until a nonblank line is encountered. 


DELB 
mm INSB 


Positions the cursor at the first line in the file. When 
aa FIRST shifted, 
F4 WR 


positions the cursor to the last line in the file. 
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Key Description 


Cancels any marks you have set. If you set no marks, 
ye UNDO 
FS Uithle 


undoes the most recent change made to your file during your 
current editing session. Pressing: 


geome UNDO 
again removes the next most recent change, and so on. 
aie Stops the current editing session. If your file is an 
ome QUIT indirect access file, the changes you’ve made will not become 


permanent when you end the terminal session. If your file is 
direct access, the changes will become permanent. 


LOCNXT Prompts you to enter the text you want to locate. When you 
wae LOCATE enter the text and press: 


FSE locates the text, positioning the cursor at the first 
character of the text string. When shifted, 


wae LOCNXT 


locates the next occurrence of the last text located. 


80COL Sets the terminal to 132-column mode. When shifted, 


oe 132COL 
1 80COL | 


sets the terminal to 80-column mode (default). 


Positions the line the cursor is at to the middle of the 
Sem MIDDLE screen. 


| : Moves the cursor to the end of the line it 1s on. 
F10 [Speed 


Splits the line the cursor is on into two lines. If the 

F11 Sia cursor is at the beginning of the line, it inserts a blank line 
above it. Otherwise, it splits the line at the cursor position. 

‘mvas JOIN 


Joins the line the cursor is at with the next line. & 
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Key Description 


Reformats lines you marked to conform to margins set with 
the SET WORD FILL directive (default margins are 1 and 
65). If you set no marks, 


F13 


reformats the paragraph the cursor is at. Paragraphs are 
delimited by blank lines. Refer to the description of the SET 
WORD FILL directive in section 4 for more information. 


say. Copies the lines or characters set by the MARK or 
F14 (oelsad MRKCHR function. 


| Centers the line the cursor is on according to the 
F15 (@aheas boundaries set by the SET WORD FILL directive (described 


in section 4). Default margins are 1 and 65. 


po Undefined. 
F16 


For details on how to define or redefine the programmable function keys, 
refer to section 6, Advanced FSE Functions. 


mmm PARA 


For information on default programmable function key settings for other 
supported terminals, refer to appendix D, Terminal Support Information. 
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Entering Directives 


There will be occasions when the functions provided by the previously 
described terminal keys do not meet your editing needs. In addition to 
function keys, FSE provides a number of directives (the directives are 
described in detail in section 4, FSE Directives). 


To enter a directive, press: 


This positions the cursor on the FSE directive line at the top of the screen; 
there you enter the FSE directive followed by: 


The directive uses the position the cursor was in just before you pressed: 


If FSE does not recognize your entry as a valid FSE directive, it positions the 
cursor at the point where the directive becomes unrecognizable. For example, 
suppose you entered a misspelled form of the UNDO directive. 


UMDO 


FSE positions the cursor at the M because that is the point at which it could 
not recognize the entry. 


UMDO 
You then type the correction over the mistake and press: 


to try again. If you press: 


without making a correction, FSE still does not recognize the directive, and 
will ignore it, erasing the directive line. Check the spelling of the directive 
and try again. 
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FSE Command 3 


The FSE command starts the Full Screen Editor. With this command you tell 
NOS which file is to be edited and other, optional, information. The optional 
parameters are shown in italics in the following descriptions; the shortest 
valid abbreviations for the values are underlined. 


You can use two formats for the FSE command. The first format is order- 
independent, that is, you can enter parameters in any order. The format is: 


FSE,F'N=filename,OP=access,Finput,L=output,lP=procedure, 
WF=workfile.directive(s) 


The second is order-dependent, that is, you must enter the parameters in the 
order shown. The format is: 


FSE,filename,access,input,output,procedure,workfile.directive(s) 
Parameter Description 


FN=filename Specifies the file you want to edit. filename must be a 
local file, unless you specify the OP=GET parameter. If 
you do not include a file name on the FSE command, FSE 
either resumes your previous editing session or, if you had 
no previous editing session, prompts you for a file name. 


OP=access Specifies the character set and/or the location of the file 
to be edited. The following are valid access parameter 
entries. 


Value Description 
DISPLAY Specifies 6-bit display code. 


NORMAL _ Specifies 6-bit display code (default if your 
terminal is in normal mode). 


ASCII Specifies NOS 6/12-bit display code (default 
if your terminal is in ASCII mode). 


ASCII8 Specifies 7-bit ASCII code right-justified in a 
12-bit byte. 


GET Makes the specified file local by either 
getting an indirect access file or attaching a 
direct access file. 
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Parameter 


Finput 


L=output 


IP=procedure 


WF-workfile 


directive(s) 


Description 


Both character set and location can be specified as 
single-letter abbreviations, and must not be separated by 
commas, for example: 


OP=GA or GA 


When you specify access, you must also specify a file 
name. 


Specifies an input (directive) file other than the default 
file INPUT. 


Specifies an output (listing) file other than the default file 
OUTPUT. 


Enables you to change the default procedure library from 
FSEPROC to the file of your choice. 


Enables you to specify a work file other than the default 
file ZZZWORK. 


Allows you to enter FSE directives within the FSE 
command itself. This parameter must be preceded by a 
period. To enter more than one directive on the FSE 
command, separate them with a semicolon. The & 
directives can use all of the command line; if you have 

sequence numbers on the right end of command lines, 

terminate the last directive on the line with the delimiters 


bf 


If neither the input file nor output file you specify is assigned to your 
terminal, FSE executes in batch mode. 


NOTE 


When FSE executes in batch mode, the input file must be in the 6/12-bit 
display code format. To increase the efficiency of batch processing, set the 
undo feature to NO. (For details, refer to the description of the UNDO 
parameter of the SET directive in section 4). 
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Before entering the FSE command, you determine the editing mode by 
entering either the NOS SCREEN or the NOS LINE command. During an 
editing session, you can change to the other mode of editing by using the 
SET directive (described in section 4). This directive affects only the editing 
session during which it is entered. The NOS command you entered before 
starting FSE resumes effect for the following editing session. This only 
applies if you resume a session. If you start a session, you will return to line 
mode (the default). 


For example, suppose you enter the NOS SCREEN command and start FSE, 
editing file MYFILE. Then, within FSE you use the SET LINE directive to 
switch to line editing. After line editing for a while, you enter the QUIT 
directive. The next time you enter the FSE directive without parameters (to 
resume your F'SE editing session), you are returned to file MYFILE in screen 
mode (your original NOS SCREEN command). 
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» FSE Directives 4 
@ 


FSE directives tell FSE what to do. When screen editing, you enter directives 
on the directive line. When line editing, you enter directives after the 
2? prompt. In both modes, you must press: 


after the directive to begin execution. 


Directive Syntax 


Most directives begin with a verb, followed by qualifiers called directive 
parameters. (Some directives begin with a special character followed by a 
verb.) 


You can often figure out how to specify a directive by thinking of it as a 
sentence. For example: 


Sentence Directive 
Locate all occurrences LOCATE ALL /abc/ 
of abc. 
© Move line 12 to just MOVE 12 TO 50 
after line 50. 
Replace the next three REPLACE NEXT 3 /abc/xyz/ 
occurrences of abc 
with xyz. 


Abbreviations and Spaces 


In directives, you can abbreviate words (other than file names) by specifying 
either the first letter or the first three letters. An entry can use uppercase 
letters, lowercase letters, or a combination. For example, you can enter 


LOCATE as: 


L 
Loc 


@ Locate 
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Although spaces or commas are required between numbers, they are not 
required between words. Using abbreviations and eliminating unnecessary 
spaces results in compact entries, as in the following examples. 


Long Version Compact Version 
COPY 20 TO 50 C20T50 
MOVE 20 50 TO 100 M20 50T100 


LOCATE ALL WORD/XVAR/ LAW/XVAR/ 


Parameter Order 


With few exceptions, you can specify directive parameters in any order. For 
example, the following directives all locate each occurrence of the word 
XVAR. 


LAW/XVAR/ 
L/XVAR/AW 


LW/XVAR/A 


String Delimiters 


In the preceding directives, slashes serve as delimiters for the string XVAR. 
However, if a string is the last parameter on a directive line, and the string 
does not end in a blank, you can omit the closing string delimiter, as, for 
example, in the directive: 


LAW/XVAR 


NOTE 


In batch jobs and FSE procedures, do not omit the closing string delimiter. 
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@ Misspelled Directives 


FSE does not recognize that a directive is misspelled. Instead, it assumes 

that any directive it does not recognize is abbreviated and reads as 

parameters any characters following the first. For example, suppose you 
e enter the following misspelled COPY directive. 


CORY 10 TO 50 


Because FSE does not recognize a directive, it assumes you used the C 
abbreviation for COPY and then tries to read the O as a parameter. In this 
case, there is no COPY parameter that can be abbreviated to O, so FSE 
displays an error message. 


Combining Directives 
By separating directives with semicolons, you can enter more than one 
directive on a line. The following example is a combination of the LOCATE 


and VIEW directives. 


L/SUBROUTINE/;V 


If there is an error in the syntax of the first directive, FSE stops and 
displays an error message; it does not execute the second directive. 
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Conventions 


When describing the FSE directives and parameters in the remainder of this 
section, we use the following conventions. 


e The shortest allowable abbreviated entry is underlined. 


e Optional parameters are in italics. In most cases, it appears that all the 
parameters are optional. This is technically true, but once you include a 
particular parameter, others may no longer be optional. 


e Examples show the directives and parameters abbreviated in uppercase 
letters. 


e To make the examples more readable, spaces are left between many 
parameters, although they are not required. For example, the directive: 


MOVE 20 50 TO 100 
could be entered as: 
M20 507100 
but would appear in examples as: 


M 20 50 T 100 
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@ Common Parameters 


Most directives use at least one parameter from the following common set. 
Using these parameters with a particular directive is described later in this 
section. The detailed descriptions of the possible values for each parameter 


follow. 
Parameter 


direction 


(file) 
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Description 


Specifies the direction FSE is to move through the file and the 
number of times it is to execute the directive. The default is 
forward. Possible values and their descriptions are: 


Value 


NEXT num 


PREVIOUS num 


REPEAT num 


Meaning 


Instructs FSE to move forward through the 
file, beginning the specified operation on 
the next line and executing it num times. 
The default setting for num is 1. 


Instructs FSE to move backward through 
the file, beginning the specified operation at 
the previous line and executing it num 
times. The default setting for num is 1. 


Specifies the number of times an operation 
is to be executed starting at the current line. 
REPEAT always moves forward. The 
default setting for num is 1. 


Specifies a NOS local file name. NOS file names can be seven 
or fewer alphanumeric characters. The default is the current 
file. The parentheses are required. 
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Parameter Description 


line Specifies the line or lines to be affected by the directive. The 
default line setting is the current line. Possible values are: 


Value Meaning 


line number The number of a particular line within the 
file. 


In an unsequenced file, line number 1 is the 
first line of the file, ine number 10 is the 
tenth, and so on. 


In a sequenced file, line number is the 
sequence number of the line, for example, 
line number 20 is the line assigned the 
sequence number 20, rather than the 20th 
line of the file (they may be the same, but 
not necessarily). 


ALL All lines in the file. 
direction One of the direction parameter values: 


NEXT num | 
PREVIOUS num © 
REPEAT num 


num is the number of times the directive is 
to be executed. 


CURRENT The current line, that is, either the line the 
cursor is on (for screen editing) or the last 
line displayed (for line editing). 
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Value 
FIRST 
LAST 


@ line + num 


line - num 
X or Y or Z 
line (file) 
Revision B 


Meaning 
The first line in the file. 
The last line in the file. 


The number of a particular line plus a 
specified value. For example, in an 
unsequenced file, 38 + 45 specifies the 83rd 
line in the file; in a sequenced file, 38 + 45 
specifies the 45th line after the line with the 
sequence number 38 (this may not be the 
83rd line). 


For both file types, C + 10 specifies the 10th 
line after the current line. 


The number of a particular line minus a 
specified value. For example, in an 
unsequenced file 83 - 45 specifies the 38th 
line in the file; in a sequenced file, 83 - 45 
specifies the 45th line before the line with 
the sequence number 83 (this may not be the 
38th line). 


For both file types, L - 1 specifies the next to 
last line in the file. 


Specifies the X, Y, or Z position pointer. 
Refer to the SET directive for information 
on the X, Y, and Z pointers. 


Specifies a line from another file. Any of the 
line parameter values can be followed by a 
file name. The parentheses are required. 
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Parameter Description 


range Specifies either a line or a range of lines to be affected by the 
directive. The default is the current line. Valid range parameter 
entries are: 
Value Meaning 
line One of the line parameter values. 
line line A group of lines delimited by two line 


parameter values. 


MARK Lines marked with the F1 QZGYM key or 
the SET MARK directive. 
SCREEN Lines appearing on the current screen 


(screen mode only). 


string Specifies a text string. The default string parameter is the last 
specified string. If a string parameter is the last parameter on a 
directive, you do not need a closing delimiter. Valid string 
parameter entries are: 


Value Meaning 

/text/ Specifies the string text. 
text” Specifies the string text. 
text’ Specifies the string text. 
\te/xt\ Specifies the string te/xt. 


/textl/../text2/ Specifies the string beginning with text1 
and ending with text2 on the same line and 
including any text between. 


In the remainder of this section we list all the FSE directives in alphabetical 
order, show their formats, and describe their parameters. For a parameter 
that is one of the common set, refer to either the Common Parameter Index 
on the inside front cover for a listing of the possible entries or to Common 
Parameters earlier in this section for detailed descriptions. 
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@ ALTER 


Enables you to change lines by entering either a string or one of the 
modification characters (described later). 


a] Without Parameters 


When you are screen editing and you enter ALTER with no parameters, FSE 
prompts you with: 


<-- ALTER WHAT? 


You then enter the text or modification character to change the current line. 
The modification characters are: 


Modification 

Character Effect 

# Deletes a character. 

& Replaces a character with a space. 


! Erases the current character and any following characters. 
Anything entered after ! is moved to the end of the 


@ shortened line. 


“characters# Inserts the string characters before the character the ~ is 
positioned under. 


When you enter an alphanumeric character other than those listed here, it 
replaces the existing character. 


When you are line editing and you enter ALTER with no parameters, FSE 
displays the current line and prompts you for changes, as for example: 


75 DIMENSIOM TAB(33))xx 
A?? 


You then space over to the position under the character to be edited and use 
one of the modification characters to make your change. 


In this example, you could make the following changes. 


75 DIMENSIOM TAB(33)) xx 


A?? N )! 
@ The line appears as: 


75 DIMENSION TAB(3) 
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Format 


ALTER END direction string range Q UIET 


Parameters 


END 
Adds a string at the end of a line. For example, 
A E/abc/ 
adds the string abc to the end of the current line. 
direction 


Specifies the direction ALTER is to move and the number of times the 
directive is to be executed. (This is a common parameter. For a listing of 
possible entries, refer to the Common Parameter Index on the inside front 
cover.) 


The following ALTER directive: 
A P 2/#/ 
deletes the first character of the two previous lines. 
string 


Specifies the text or modification characters to change or replace the 
current line. (This is a common parameter. For a listing of possible 
entries, refer to the Common Parameter Index on the inside front cover.) 


A * atthe end of an ALTER string tells FSE to change the line and then 
prompt you for more changes. 
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@ range 


Specifies the lines to be altered. (This is a common parameter. For a 
listing of possible entries, refer to the Common Parameter Index on the 
inside front cover.) 


The following ALTER directive: 
A A/” #/ 
inserts a space at the beginning of all lines in the file. 


If you specify a group of lines on an ALTER directive, you are prompted 
only once; the same corrections are made to all the lines in the group. 


A primary use of ALTER during screen editing is to indent blocks of text. 
For example, the following ALTER directives perform the described 
function on lines you have previously marked. 


Directive Function 

A M/###/ Deletes the three leftmost characters from all marked 
lines. 

AM/" #/ Inserts three spaces at the beginning of the marked 
lines. 


©} QUIET 


Instructs FSE not to display the results of the ALTER directive. 
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BACK 


Returns you to a file you already edited during the current editing session. 


Format 


BACK 


Example 


You are line editing file MYFILE in line mode and enter HELP. This accesses 
the FSE HELP file and prints the first nine lines. 


2? 
FULL SCREEN EDITOR HELP 

FSE directives tell FSE what to do. To get information on a directive, 

enter HELP followed by the directive name. For example, HELP COPY. 


For more detailed information, see the FSE User's Guide. The 
directives are: 


OON AU BRWN = TF 


ALTER FSE LOCATE REPLACE s- “DOT 


29 


To return to editing file MYFILE only, either enter the BACK directive or 
press: 


on the Viking 721 terminal. FSE remembers the last seven files you edited. 
By successively entering: 


BACK 
or pressing: 


you can return to all seven files. The directive will not return you to a file if 
you have ended the editing session. Refer to the FSE directive description for 
another way to access a previously edited file. 
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& COPY 


Copies lines from one location to another, either within a file or between two 
files. 


@ Without Parameters 


If you do not specify parameters, the copied line appears immediately below 
the original. 


Format 


COPY range (filel) TO line (file2) QUIET 


Parameters 
range 


Specifies the lines to be copied. (This is a common parameter. For a listing 
of possible entries, refer to the Common Parameter Index on the inside 
front cover.) 


@ (file 1) 


Specifies the file containing the lines to be copied. Any NOS file name is 
valid. The default is the current file. 


TO 
Separates the copied lines from their destination. 
line 


Specifies the line after which the copied lines will appear. This can be 
either a line in the current file or, when combined with the (file2) 
parameter, a line in another file. (This is a common parameter. For a 
listing of possible entries, refer to the Common Parameter Index on the 
inside front cover.) 


For example, to copy lines 17 through 25 immediately after line 65, enter: 


@ C 17 25 TO 65 
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When you are line editing, FSE displays the copied lines with their new 
line numbers. 


66 6 IF(.NOT.PARMERR) GO TO 5 


67 OPEN(3, FILE="OUTPUT') 

68 WRITE(3,*) COND 

69 STOP "INVALID PARAMETER. ' 

70 C 

71. & IF CTABC1).GT.TAB(2) .OR. TAB(2).GT.TAB(3)) THEN 
72 COND="INVALID TABS (T1>T2 OR T2>T3). 

73 GO TO 6 

74 ENDIF 


When you are screen editing, FSE moves the cursor to the first copied line 
in its new position. 


When you are screen editing and use the key, it copies before, 
rather than after, the line indicated, because executes the 
following directive. 


C M T0 P (COPY MARK TO PREVIOUS) 
(file2) 


Specifies the file (any NOS file name) to which the lines are to be copied; 
used only if the destination is other than (filel). For example, the 
following directive copies all of file X to the end of file Y. & 


C A (X) TOL CY) 


To specify the line after which the copied lines are to appear, include the 
line parameter before the (file2) parameter. For example, to copy lines 10 
through 50 of file MYFILE (the current file) to after line 20 of file Y, enter: 


¢ 10 50 TO 20 CY) 
QUIET 


Instructs FSE not to display the results of the COPY directive. 
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5 | 


DELETE 


Deletes one or more lines. 


® Without Parameters 


If you do not specify any parameters, the current line is deleted. 


Format 


DELETE range BLANK WORD IN tab QUIET 


Parameters 
range 


Specifies the lines to be affected by the directive. (This is a common 
parameter. For a listing of possible entries, refer to the Common 
Parameter Index on the inside front cover.) 


For example, to delete lines 30 through 338, enter: 
D 30 33 


In line editing mode, lines 30 through 33 are then printed, showing you 
the lines you have deleted. 


30 5 ERR=0 


31 PARMERR=. FALSE. 
32 CALL GETPARMCPNAME , PVAL, ERR) 
33 IF CERR)4,3,5 


When you are screen editing, the lines just disappear. 


After a DELETE directive, the current line is the line just before the 
deleted lines. In the preceding example, that would be line 29. 


When you are screen editing, a quick way to delete a group of lines is to 
mark the first and last lines of the group using: 


a MARK 


Then enter: 
DM 


and the marked lines are deleted. 
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DELETE followed by INSERT can be used to replace lines. For example, 


D;I 


deletes the current line and prompts you to insert new lines in its place. 


BLANK & 


Deletes all blank lines, from the current cursor position to the first 
nonblank line. 


In the following example, to delete all the blank lines but one, you would 
position the cursor on the second blank line and enter DELETE BLANK (or 


press F3 P]3RE] ). 


~— LOCNXT.— 8OCOL. 
QUIT F? LOCATE F8 132COL 
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6 The following screen results: 
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WORD 


Deletes characters within a line without deleting the line. Its exact 
function depends on where the cursor is positioned. 


If the cursor is on a blank, DELETE WORD deletes that blank and any 
blanks immediately after it. 


If the cursor is on an alphanumeric character, DELETE WORD deletes 
that character, any alphanumeric characters immediately after it, and 
any blanks immediately after that. 


If the cursor is on any other kind of character, only that character is 
deleted. 


For example, you want to delete the first occurrence of the word intended 
on the following screen. Position the cursor at the i in intended. 
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Then press: 
and enter: 
DW 
The first occurrence of the word intended is deleted. 
This document is: intended to provide background information to 
add to the body of knowledge provided by the Help file. You should read and 


understand the entire Help file as a prerequisite to using this study 
guide. To access the Help file, press HELP. 


For information on deleting one character at a time, refer to . (Dot) later in 
this section. 


IN tab 
Deletes a specified tab field. For example, if you set tabs to 1, 7, and 72, 
D IN 1 


deletes columns 1 through 6 in the current line and shifts the remaining 
text left 6 columns. 


& QUIET 


Instructs FSE not to display the results of a deletion. 
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FSE 


Specifies a different file to edit. The cursor is positioned at the first line of the 
file. If you were previously editing the file, the line you were working on is 
moved to the top of screen. 


Without Parameters 


You must specify a file parameter on the FSE directive. 


Format 


FSE file charset GET READ SPLIT 


Parameters 
file 


Specifies the name of the file you want to edit. Any NOS file name is 
valid. 


If you do not specify the GET or READ parameters, FSE uses its latest 
copy of the file. If the file does not exist, FSE creates a new file with the 
specified name. 


charset 
Specifies the character set to be used by FSE. Enter one of the following: 
Entry Character Set Code 
DISPLAY  6-bit display code (default). 
NORMAL 6-bit display code. 
ASCII 6/12-bit display code (ASCII 95-character set). 


ASCII8 7-bit ASCII code, right-justified in a 12-bit byte. 
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& GET 


Instructs FSE to retrieve a permanent file and refreshes the editor 
workspace. A GET is performed for indirect access files; ATTACH is 
performed for direct access files. Any changes you have made that aren’t 
permanent will be lost. If there is no permanent copy of the file, FSE 
reads a local copy. 


READ 


Refreshes the file image in the editor workspace without a GET or 
ATTACH operation. Whatever is local (indirect access) or attached (direct 
access) is read. All changes that aren’t permanent are lost. 


SPLIT 


Divides the screen horizontally to allow editing of two different files. The 
current file is displayed in the upper half of the screen. The file specified 
with the FSE directive is displayed in the lower half. You can split one 
file in order to edit different parts of it. To do this, specify the current file 
name in the FSE directive. If the two displays overlap the same text, 
changes will be made to both simultaneously. 


The SET VIEW SPLIT directive allows you to specify the number of lines 
in each portion of the screen; the default is half the screen. 
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G 


ET 


Either displays information on the files you are editing or lists the column 
numbers. 


Without Parameters 


You must specify either STATUS or ALIGN. 


Format 


GET STATUS ALIGN 


Parameters 


STATUS 
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Displays information on the files you are editing. Following is an 
example of the information you receive when you enter GET STATUS in 


screen mode. 


EDITOR STATUS INFORMATION: 


LOCK CHANGE CHARSET NUMBERED SIZE POSITION 
YES DISPLAY 


FILES: NAME 
FILE1 NO 
FSEPROC NO 


FSEHELP YES 


(CURRENT) TEXT 


NO 


TAB COLUMNS: 7 72 


TAB CHARACTER: \ 


FUNCTIONS: KEY 
F1 
F2 
F3 
F4 
F5 
F6 
F7 
F8 
F9 
F10 
F11 
F12 
F13 
F14 
F15 
F16 


WARNING WIDTH: 


LABEL 
MARK 
MOVE 
INSB 
FIRST 
UNDO 
QUIT 

LOCATE 

132COL 

MIDDLE 

ENDLIN 
SPLIT 
JOIN 
PARA 
COPY 

CENTER 
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NO DISPLAY 
NO ASCII 
YES ASCII8 


DIRECTIVES 
SM 

MMTP 

IBP 

PF 

UNDO 

QUIT 

L/&?/ 
SVC132 


160 


YES 293 
NO 4/7 
NO 542 
NO 103 


PARAGRAPH MARGINS: 


KEY 
SHIFT F1 
SHIFT F2 
SHIFT F3 
SHIFT F4 


SHIFT F7? 
SHIFT F8 


<--PRESS NEXT TO CONTINUE 


1 
1 


34 
9 
1 65 5 
LABEL DIRECTIVES 
MRKCHR SMW 
COPY CMTP 
DELB DB 
LAST VL 
LOCNXT LN 
80COL Svcs 
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® Field Description 


NAME Local files you have been editing. The current 
file is prefixed with (CURRENT). 


LOCK Read-only status. YES means a read-only file: 
@ you cannot make permanent changes. NO means 
that you can make permanent changes. 


CHANGE Specifies whether you made any changes to the 
file. YES means you have;NO means you have 
not. 


CHARSET Character set currently in effect for the specified 
file. Possible entries are: 


DISPLAY 
ASCII 
ASCII8 


NUMBERED Line number status. YES means it is a sequenced 
file; NO means it is not a sequenced file. 


SIZE Total number of lines in the file. 
POSITION Line number of the current cursor position in the 
} file. For local files not currently being edited, 

this is the position at which the cursor will be 
located when you reenter the file. 

TAB COLUMNS Column numbers of the current tabs. 

TAB CHARACTER Current tab character. Default is \. 

WARNING WIDTH Current line length limit. 


PARAGRAPH MARGINS Current margins set for use by the .FILL and 
.CENTER directives [refer to the . (Dot) 
directive]. The first two numbers are the left and 
nght margins; the third number is the column in 
which the first line of a paragraph will begin. 


FUNCTIONS Current labels and directives associated with the 
programmable function keys. 


Revision A FSE Directives 4-23 


When screen editing, press: 


to return to the previous screen. 


ALIGN 


Writes the column numbers of the current line over the text on the line. 
The alignment information has no effect on the line over which it is 
written. The following example shows the information you receive when 
you enter GET ALIGN. 


IMPLICIT INTEGER (CA~-Z) 
PARAMETER (PRM=1,PRMC=2,SEC=3,SECC=4, TER=5, TERC=6) 
PARAMETER (MSC=50) 
PARAMETER (MAXILEN=160,MAXSLEN=310,MAXOLEN=160) 
1234567890 PSL ieeka! 234567890 Peet ie-ko8)] 234567890 Ree bl aesva8)! 234567890 eee eivaeckas) 
CHARACTER*1 CO,CN 
CHARACTER*10 SLANTS 
CHARACTER*12 FMTST 
CHARACTER* (MAXILEN) INPLIN 


When you are screen editing, the alignment information is written on the 
current line and stays on the screen until that part of the screen is 
rewritten. 
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@ HELP 


Displays the FSE HELP file, which contains descriptions of the FSE 
directives and their parameters. 


& Without Parameters 


If a directive is not specified, the cursor is positioned at the first line of the 
HELP file. 


Format 


HELP directive 


Parameter 
directive 


Specifies the name of a directive; the cursor is positioned at the first 
occurrence of the directive in the HELP file. 


For example, to locate information on the REPLACE directive, enter: 


@ H REPLACE 


The cursor is then positioned at the description of the REPLACE directive 
within the HELP file. You can also abbreviate the directive you want help 
with. For example, HELP REPLACE can be entered as: 


HR 
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When you enter the HELP directive (or press ) while screen 
editing, the screen is split into two equal parts, with the HELP file 
displayed on the lower half of the screen. 
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© Remarks 


When you use the HELP directive while line editing, FSE not only accesses 
the HELP file, but also prints several lines of text. You are then positioned in 
the HELP file so you can display more text with PRINT directives. 


@ By default the HELP file is a direct access, public, read-only, permanent file. 
~ The default name is FSEHELP from user name LIBRARY. You can, 
however, assign any file you want to be the default HELP file. To do this, 
create a local file named FSEHELP and, when the HELP directive is entered 
(or the key is pressed) your local copy of FSEHELP is used as the 
default HELP file. 


To exit the HELP file, either use the BACK directive or press : 


Revision A FSE Directives 4.27 


INSERT 


Inserts text. 


Without Parameters 


When you are screen editing and enter the INSERT directive without 
parameters, you are prompted with the following message. 


<--- INSERT WHAT? 


You then enter the text you want to insert. This text will appear as a line 
after the current line. 


When you are line editing and enter the INSERT directive without 
parameters, you are prompted to enter new lines of text until you enter either 
a line with a tab character at the end or an empty line ( only.) In the 
following example, the current line is line 31. 


22 I 

32? inserted Line 1 

33? inserted Line 2 

34? inserted Line 3 

35? (The user ends the insert.) 


a 


If you want the inserted line to begin at a certain tab, include the appropriate 
number of tab characters before the text you insert. For example, if tabs are 
set at columns 7 and 72 and you want the inserted line 32 to begin at column 
7, enter: 


32?\inserted Line 1 


\ is the tab character. Refer to the SET CHAR directive for information on 
the soft tab character. 
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é Format 


INSERT line PREVIOUS string BLANK WORD 


Parameters 


line 


The lines affected by the insert. (This is a common parameter. Fora 
listing of possible entries, refer to the Common Parameter Index on the 
inside front cover.) 


PREVIOUS 


Specifies that you want the insertion before a character or line rather 
than after. 


string 


The text you want to insert. When you specify a string, the string is 
inserted as a single line after the current line. This is a common 
parameter. For a listing of possible entries, refer to the Common 
Parameter Index on the inside front cover. 


BLANK 


When you are screen editing, inserts blank lines after the current line 
(useful for entering large amounts of text). Lines of text are left at the top 
and bottom of the screen. When you are line editing, INSERT BLANK 
inserts nine blank lines in front of the current line. To remove excess 
blank lines, position the cursor at the first blank line you want to 
eliminate and use DELETE BLANK (all subsequent blank lines are 
deleted also). 


WORD 


Inserts 30 blank characters at the current cursor position. When you are 
screen editing, this is sometimes more convenient than repeatedly 
pressing . To delete excess blank characters position the cursor 
at the first blank character you want to remove and enter: 


DELETE WORD 


All subsequent blank characters are deleted also. 
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LOCATE 


Locates a specified character string. 


Without Parameters 


If you enter LOCATE without parameters, the last LOCATE string you 
specified is used. If you have not previously entered a LOCATE directive, you 
are prompted to enter the text you want to locate. 


Format 


LOCATE WORD direction string range IN tab UPPER QUIET 


Parameters 
WORD 


Instructs FSE to search for a word (defined as the specified string when it 
is contained within either nonalphanumeric characters or blanks). 


If you are line editing, it positions the cursor on the line containing the 
string. 


If you are screen editing, it positions the cursor at the first character in 
the found string. For example, suppose you want to locate the word topic 
in the following text. 


“This document is simply organized as topics, like the help file. If 
you assign this file as either FSEHELP or FSTEACH, then you can use the 


topic-search capability of the HELP or TEACH command. You should ensure 
that your topic comes from the List of topics Listed in this file. 


Press: 


and enter: 


L W/topic 
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FSE positions the cursor at the first character of the specified string. 


This document is simply organized as topics, like the help file. If 
you assign this file as either FSEHELP or FSTEACH, then you can use the 
topic-search capability of the HELP or TEACH command. You should ensure 
that your topic comes from the list of topics Listed in this file. 


Note that FSE passed the word topics in the first line because it is plural. 
It would not have done so had you not specified WORD. 


direction 


Specifies the direction LOCATE is to move in the file to find the specified 
string. FSE searches forward by default, beginning at the current cursor 
position. 


(This is a common parameter. For a listing of possible entries, refer to the 
Common Parameter Index on the inside front cover.) 


When you specify the NEXT parameter, FSE begins its search at the next 
occurrence of the string. 


When you specify PREVIOUS, FSE searches backward, beginning at the 
current cursor position. 


The number used with the NEXT, PREVIOUS, and REPEAT parameters 
refers to the number of lines located, not the number of strings. For 
example, 


LN 2 /abc/ 


means locate the next two lines containing abc, no matter how many 
times abc occurs on each line. 


If you do not specify a number, 


LOCATE NEXT/abc/ 


finds the next occurrence of abc, and 


LOCATE PREVIOUS/abc/ 


finds the previous occurrence of abc (even if it appears on the current line). 
For example, you are positioned at line 36 when line editing. 


36 This is the first and the last of the located Lines 
You then enter: 
LN /the/ 


You remain at line 36 because the line contains more than one occurrence 
of the string the. 
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string 


Specifies the string you want to locate. (This is a common parameter. For 
a listing of possible entries, refer to the Common Parameter Index on the 
inside front cover.) 


The following directive locates the string abc. & 
L/abc 


If the search is successful, LOCATE moves the cursor to the first 
character of the located string. If the search is unsuccessful, the cursor is 
not moved and the message NOT FOUND is displayed. 


If the line located is on the screen already, the cursor is simply positioned 
at that line. Otherwise, the screen is rewritten with the located line at the 
top. If you prefer to display the located line in the middle of the screen, 
follow the LOCATE directive with a VIEW directive. 


L/abc/;V 


If you do not specify a string, FSE locates the string on the most recently 
specified LOCATE directive. If you have not previously entered a 
LOCATE directive in your editing session, you are prompted with: 


<--- LOCATE WHAT? 


You then enter the string you want to find. 


To save effort when searching for a long string contained on one line, you 
can use the ellipsis search technique. If, for example, you want to locate 
the following string: 


I will inform you next Monday if a meeting is necessary. 
you can enter: 
L/I/../ary./ 


rather than specifying the entire string. You are then positioned at the 
first character of the specified string. 
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range 


Specifies the lines in which you want FSE to search for the specified 
string. This is a common parameter. For a listing of possible entries, refer 
to the Common Parameter Index on the inside front cover. 


When you are screen editing and locate more than one occurrence of a 
string, FSE displays a directory of all the lines affected. For example, if 
you were to enter: 


L A/PARAMETER/ 


the screen might display: 


<-- ENTER LINE NUMBER OR PRESS NEXT 
File MYFILE Displaying located lines 


9 PARAMETER (PRM=1,PRMC=2,SEC=3,SECC=4, TER=5, TERC=6) 
10 PARAMETER (MSC=50) 

11 PARAMETER (MAXILEN=160,MAXSLEN=310,MAXOLEN=160) 

62 COND= ‘INVALID PARAMETER - ' // PNAME 

69 STOP ‘INVALID PARAMETER. ' 


You could then press: 


either to view another page of affected lines or, if there are no more pages, 
to position the cursor in the file at the last line affected. 


If you either enter a line number on the directive line or position the 
cursor at a line in the directory and then press: 


the cursor is positioned at that line in the file. 
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IN tab 


Locates a specified string appearing within a field bounded by tabs (tab 
represents the tab field). For example, if tabs were set at columns 5, 20, 
and 40, the tab fields would be: 


Tab 

Field |© Columns 

1 1 through 4 

2 5 through 19 

3 20 through 39 

4 40 through the end of the line 


To locate all occurrences of the string ABC in columns 20 through 39 (tab 
field 3), you would enter: 


L A/ABC/IN 3 
Refer to the SET directive description for information on setting tabs. 
UPPER 


Instructs FSE to search the file as if it were all capitalized. For example, if 
you entered: 


L U/the/N 3 
FSE might display: 


14 The first occurrence 
43 THE second occurrence 
87 the third occurrence 


The UPPER parameter is the default setting for display code files. For 
ASCII files, you must enter the exact string you want to locate. 


QUIET 


Instructs FSE not to display the located lines and positions the cursor at 
the last line located. 
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& Remarks 


If LOCATE is unsuccessful from within an FSE procedure, no more 

directives are read from that procedure line; the procedure continues at the 

start of the next line in the procedure. You can use this to conditionally 
© execute parts of a procedure. 


Examples 


The following entries are all valid LOCATE directives. 


Entry Meaning 
L F/abc Locates first occurrence of abc in the file. 
L\ab/c Locates the string ab/c. 


L 20 50/abc Locates all occurrences of abc in lines 20 through 50. 
L/abc/20 50 Locates all occurrences of abc in lines 20 through 50. 
L A/abc Locates all occurrences of abc in the edit file. 


L/abc/../xyz/  Locates the text string that begins with abc and ends with 
xyz on the same line. 


© L A/abc/IN 2 Locates all occurrences of abc between the first and second 
tab (tab field 2). 


L P 3/abc Locates the previous three lines containing abc; positions 
the cursor at the first occurrence of abc on the third line. 


LN Locates the next line in which the previously specified 
string occurs. 


L W/boat Word-oriented search; finds the next occurrence of the word 
boat. 
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MOVE 


Moves text from one place to another within a file or between two files. 


Without Parameters 


If you do not specify a parameter, nothing happens. 


Format 


MOVE range (filel) TO line (file2) QUIET 


Parameters 
range 


Specifies the lines to be moved. (This is a common parameter. For a 
listing of possible entries, refer to the Common Parameter Index on the 
inside front cover.) 


(file1) 


Specifies the file containing the lines to be moved. It can be any NOS file 
name. The default is the current file. 


TO 
Separates the lines to be moved from their destination. 
line 


Specifies the line after which the moved lines will appear. (This is a 
common parameter. For a listing of possible entries, refer to the Common 
Parameter Index on the inside front cover.) 


This parameter can designate a line either from the current file or from 
another file. The default is the last line of the file. 
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For example, to move lines 45 through 50 immediately after line 20, enter: 
M 45 50 TO 20 


When you are line editing, FSE displays the moved lines with their new 
line numbers. 


@ 21 READ(PVAL,'(11)") TAB(3) 
22 ELSE IF(PNAME.EQ.'SEP') THEN 
23 READ(PVAL,'(11)') SEPCNT 
24 IF(SEPCNT.LT.2 .OR. SEPCNT.GT.5) THEN 
25 COND='SEP MUST BE 2, 3, 4, OR 5.' 
26 PARMERR=. TRUE. 


When you are screen editing, the cursor is positioned at the first moved 
line. If you use the F2 key when screen editing, the lines are 
moved before, rather than after, the indicated line, because 

F2 executes the following directive. 


MM TO P (MOVE MARK TO PREVIOUS) 
(file2) 


Specifies the file to which the lines are to be moved; used only if the 
destination is other than (filel). Any NOS file name is valid. 


@ For example, the following directive moves lines 20 through 50 of file 
MYFILE to the end of file Y. 


M20 50 (MYFILE) TO LCY) 
The default is the current file. 
QUIET 


Instructs FSE not to display the changes, only the resulting text. 
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PRINT 


Either prints (displays) a range of lines (line editing) or positions the cursor 
(screen editing). 


Without Parameters 


If you do not specify a parameter, the current line is printed. 


Format 


PRIN T range Q UIET 


Parameters 


range 


Specifies either the lines to be printed (line editing) or the position of the 
cursor (screen editing). (This is a common parameter. For a listing of 
possible entries, refer to the Common Parameter Index on the inside front 
cover.) 


For example, to print the next three lines when line editing, you would 
enter: 


PN 3 


If you were positioned on line 30, lines 31 through 33 would be printed. 


31 5  ERR=0 
32 PARMERR=.FALSE. 
33 CALL GETPARM(PNAME ,PVAL, ERR) 


To print the current line (line 30) plus the next two, you would enter: 
PR3 


Lines 30 through 32 would be printed. 


30 LOGICAL PARMERR 
31 5  ERR=0 
32 PARMERR=. FALSE. 


When you are screen editing, rather than printing the lines, the PRINT 
directive positions the cursor at the last line of the range you specified. 
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_ The following example illustrates the difference between specifying the 
PRINT directive when line editing and when screen editing. 


When line editing, if you specify: 


2 P 10 15 


lines 10 through 15 are printed. 


10 PARAMETER (MSC=50) 

11 PARAMETER (MAXILEN=160,MAXSLEN=310,MAXOLEN=160) 
12 CHARACTER*40 COND 

13 CHARACTER*1 CO,CN 

14 CHARACTER*10 SLANTS 

15 CHARACTER*12 FMTST 


When screen editing, if you specify the same directive: 
P 10 15 
the cursor is positioned at line 15. 


CHARACTER*40 COND 
CHARACTER*1 CO,CN 
CHARACTER*10 SLANTS 
EHARACTER*12 FMTST 
© CHARACTER* (MAXILEN) INPLIN 
CHARACTER*7 PVAL,PNAME 
CHARACTER*7 INPFILE,OUTFILE 
CHARACTER*50 PENTRY,SENTRY, TENTRY,BLANK 
LOGICAL PARMERR 


When screen editing, think of the PRINT directive as a positioning 
directive, because it positions the cursor to a specified line. The following 
PRINT directives may prove useful during screen editing. 


PL Positions you to the last line of the file. 

P F Positions you to the first line of the file. 

P 1 Positions you to the first line of the file. 
QUIET 


Instructs FSE not to print the specified lines, but instead to position the 
© cursor at the last line specified. 
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QUIT 


Exits FSE or an FSE procedure. 


Without Parameters & 


If you enter QUIT without parameters, you exit FSE, changing only the local 
copies of your files. The exception is when you have attached a direct access 
file in write mode. In this case, entering QUIT without parameters makes 
your changes permanent. 


Format 


QUIT REPLACE QUIET UNDO PROC /NOS command 


Parameters 


REPLACE 


Instructs FSE to make your changes permanent by defining, replacing, or 
copying to permanent storage as necessary. If you have created a new file 
within FSE, use the REPLACE parameter to make it permanent. ® 


The REPLACE and UNDO parameters cannot be included in the same 
QUIT directive. 


QUIET 
Instructs FSE not to print the file status messages when it is stopped. 
UNDO 


Undoes all changes made during your current editing session. If you 
specify the UNDO parameter, all changes made since the last time you 
entered FSE are lost. It also becomes impossible to return to the point at 
which you stopped FSE during this editing session. 


The REPLACE and UNDO parameters cannot be included in the same 
QUIT directive. 


NOTE 


The UNDO parameter is the only parameter in FSE that must be completely & 
spelled out. 
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© PROC 


Used only in FSE procedures; instructs FSE to stop processing the 
current procedure without exiting FSE. QP (QUIT PROC) can be used 
without parameters in place of an EOR to separate procedures. Ordinarily 
QP should be by itself at the start of the line. Exceptions may occur in 
conditional procedures. (For examples of conditional procedures, refer to 
Conditional Procedures in section 6.) 


/ NOS command 


Performs the function specified by the NOS command you enter. For 
example, to stop FSE, replace changed files, and reenter FSE, enter: 


Q R/FSE 


Anything on the line following the / is considered part of the NOS 
command. 


Remarks 


When you exit FSE using the QUIT directive, a message of the following 
type appears. 


FILE: filename (status) 


Field Description 
filename Name of a file you have accessed during your editing session. 


status May be any of the following. 


LOCAL Either you have created a file and have 
not made it permanent (it will disappear 
when you log off NOS) or you have made 
changes to a permanent file and have not 
made the changes permanent (the changes 
you made will not be there the next time 
you access the file). To make a file (or 


changes to a file) permanent, enter the 
QUIT REPLACE directive (QR). 
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Field Description 


NO CHANGES No changes have been made to the file. 


PERMANENT You have replaced the permanent copy of 
the file with the changed local copy. 


READ-ONLY FILE You may not make any changes to the 
permanent copy of the specified file. 


If no message appears following a file name, you have made 
changes only to the local copy of a file; the changes are not 
permanent. 


For example, if you entered the QUIT REPLACE directive to stop FSE while 
editing file MYFILE, the following messages might appear. 


FILE: MYFILE (PERMANENT) 
FILE: FSEPROC (NO CHANGES) 
FILE: FSEHELP (NO CHANGES) (READ-ONLY FILE) 


The PERMANENT message tells you that the changes you made to file 
MYFILE are now permanent. This message appears when you use the 
REPLACE parameter. 


File FSEPROC is always one of the files FSE accesses. In this example, the 
NO CHANGES message means you have not made any changes to file 
FSEPROC. 


File FSEHELP is the online help file that is made available to FSE when 
you enter the HELP directive or press HELP. The READ-ONLY FILE 
message means you cannot make any permanent changes to the file. 


If you do not want these messages displayed when you stop FSE, include the 
QUIET parameter. 
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@ REPLACE 
é fk 


Replaces one text string with another. 


The REPLACE directive works very much like the LOCATE directive. The 
| difference is that the REPLACE directive locates the string you specify and 
& then replaces it with another string (that you also specify). 


Without Parameters 


If you do not specify a parameter, REPLACE uses the last string specified 
and executes the directive. If you have not previously specified a REPLACE 
string, you are prompted for the intended text. 


Format 


REPLACE WORD direction string! string2 range 
IN tab UPPER QUIET 


Parameters 


WORD 


© Instructs FSE to search for and replace a word (word is defined as string] 
when it is contained within either nonalphanumeric characters or 
blanks). For example, to replace the word topic with the word subject in 
the following text: 


This document is simply organized as topics, like the help file. If 
you assign this file as either FSEHELP or FSTEACH, then you can use the 
topic~search capability of the HELP or TEACH command. You should ensure 
that your topic comes from the list of topics listed in this file. 


press: 


and enter: 
R W/topic/subject/ 
FSE replaces the first occurrence of the word topic with the word subject. 
& This document is simply organized as topics, like the help file. If 
you assign this file as either FSEHELP or FSTEACH, then you can use the 
Subject-search capability of the HELP or TEACH command. You should ensure 


that your topic comes from the List of topics listed in this file. 


Notice that FSE passed the word topics in the first line, because it 1s 
& plural. It would not have done so, had you not specified WORD. 
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direction 


The direction REPLACE is to move in the file. (This is a common 
parameter. For a listing of possible entries, refer to the Common 
Parameter Index on the inside front cover.) 


F'SE searches forward by default, beginning at the current cursor 
position. 


When you specify NEXT, FSE begins its replacement at the next 
occurrence of string1, in effect skipping an occurrence. 


When you specify PREVIOUS, FSE searches backward, beginning at the 
current cursor position and skipping the last string] located. 


Using a number greater than 1 with the NEXT, PREVIOUS, and 
REPEAT parameters specifies the number of lines to search (rather than 
the number of occurrences to replace). 


For example: 


RN 2 /abc/xyz/ 


searches the two most current lines and replaces all occurrences of abc 
with xyz. 


RN /abc/xyz/ or RN 1 /abc/xyz/ 


searches for and replaces the next occurrence of abe with xyz. 

RC C /abc/xyz 
replaces all occurrences from one end of the current line to the other. 
Examples: 


Suppose that the cursor is positioned at the beginning of the following 
lines. 


A Line of abc,abc,abc. 
A second Line of abc,abc,abc. 
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@ Press: 


and enter: 
@ RN /abc/xyz/ (orR N 1 /abc/xyz/) 
and you get: 


A line of xyz,abc,abc. 
A second Line of abc,abc,abc. 


Enter: 
RN 2 /abc/xyz/ 
and you produce: 


A line of xyz,xyz,xyz. 
A second Line of xyz,xyz,xyz. 


Enter: 
RC C /abc/xyz/ 


and the result is: 


@ A line of xyz,xyz,xyZ. 


A second Line of abc,abc,abc 
string 1 


The string you want replaced. (This is a common parameter. For a list of 
possible entries, refer to the Common Parameter Index on the inside front 
cover.) 


If you do not specify string1, FSE uses string! on the most recently 
specified REPLACE directive. If, however, you have not previously 
entered a REPLACE directive in your editing session, you are prompted to 
enter the intended text. 
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To replace a long string contained on a line, use the ellipsis search @ 
technique, which allows you to replace a long string without typing it out | 
entirely. For example, you want to replace the string: 


I will inform you next Monday if a meeting is necessary. 

with the string: ] 
No meeting 1s necessary. 

Rather than specifying the entire first string, enter: 
R/I/../ary./No meeting 1S necessary./ 

The first string is then replaced with the second. 


If FSE cannot find string1, it displays the messageNOT FOUND. If FSE 
cannot find a string] from within an FSE procedure, no more directives 
are read from that procedure line (if the line contains more than one 
directive); execution continues at the start of the next line in the 
procedure. 


string2 


The string you want to substitute for string1. (This is a common 
parameter. For a list of possible entries, refer to the Common Parameter 
Index on the inside front cover.) 


For example, suppose the cursor is positioned at the line: 

I iill inform you next Monday if a meeting 1s necessary. 
and you want to replace the first 1 with w, enter: 

R/i/w 


FSE locates the first line containing i and replaces the first 1 with w. The 
following line results: 


I will inform you next Monday if a meeting is necessary. 


When you are screen editing, if the line affected by REPLACE is on the 
screen, the cursor is positioned at that line. Otherwise, the screen is 
rewritten with the affected line at the top. If you prefer to display the 
affected line in the middle of the screen, follow the REPLACE directive 
with a VIEW directive, as follows: 


R/abc/xyz/ ; V & 
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& range 


Specifies the lines to be affected by the REPLACE directive. (This is a 
common parameter. For a listing of all possible entries, refer to the 
Common Parameter Index on the inside front cover.) 


@ When you are screen editing and replace more than one occurrence of a 
string, FSE displays a directory of all the lines affected. For example, if 
you were to enter: 


R A/PARAMETER/PARAM/ 
the screen might display: 


<-- ENTER UNDO OR PRESS NEXT TO END 
File MYFILE Displaying changed Lines 


9 PARAM (PRM=1,PRMC=2,SEC=3,SECC=4, TER=5, TERC=6) 
10 PARAM (MSC=50) 
11 PARAM (MAXILEN=160,MAXSLEN=310,MAXOLEN=160) 
62 COND= ‘INVALID PARAM — ' // PNAME 
69 STOP ‘INVALID PARAM.' 
Press: 
NEXT 


either to view another page of affected lines or, if there are no more pages, 
& to position the cursor in the file at the last line affected. 


If you enter a line number on the directive line and press: 


the cursor is positioned at that line in the file. If you either enter: 
UNDO 
or press: 


F5 bee 
the REPLACE operation is undone. 
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IN tab 


Replaces text appearing only in certain tab fields. tab represents a tab 
field; for example, if tabs are set at columns 5, 20, and 40, the tab fields 
are: 


Tab 

Field Columns 

1 1 through 4 

2 5 through 19 

3 20 through 39 

4 40 through the end of the line 


To replace all occurrences of abc with xyz in columns 20 through 39 (tab 
field 3), enter: 


R A/abc/xyz/ IN 3 
Refer to the SET directive description for information on setting tabs. 
UPPER 


Instructs FSE to search the file as if it were all uppercase, that is, 
capitalization is ignored. If, for example, you entered: 


R U/abc/xyz/N3 


REPLACE would replace each of the following lines with xyz. 


14 ABC 
43 Abc 
87 abc 


The UPPER parameter is always in effect for display code files. 
QUIET 


Instructs FSE not to display the lines changed, only the results of the 
changes; positions the cursor at the last line replaced. 
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oe Examples 


The following are all valid REPLACE directives. 


Entry 


& R/abc/xyz 


R A/abc/xyz 


R\ab/c\c/pm 


R 20 50/abc/xyz 
R/abc/../xyz/1234/ 
R/abc/xyz2/IN 2 


RN 3/abc/xyz 


R/abc// 
@ R//xyz/ 
R 
R/abc/xyz/M 
R/abc/xyz/S 
Revision B 


Meaning 
Replaces next occurrence of abe with xyz. 


Replaces all occurrences of abc in the file with 
XYZ. 


Replaces the string ab/c with the string c/pm. 


Replaces all occurrences of abc in lines 20 through 
90 with xyz. 


Replaces text string beginning with abc and 
ending with xyz with the string 1234. 


Replaces all occurrences of abe with xyz in tab 
field 2. 


Replaces all occurrences of abe with xyz on the 
next 3 lines (including the current line). 


Deletes the next occurrence of abc. 


Replaces the previously specified REPLACE 
string with xyz. 


Uses both previously specified strings and 
performs another REPLACE. 


Replaces abc with xyz on marked lines. 


Replaces abc with xyz on all lines currently on the 
screen. 
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SET 


Sets various F'SE and file parameters. 


Without Parameters 


You must enter a keyword after the SET directive. 


Format 


SET keyword 


Parameters 


There are many valid keywords that you can use with the SET directive. The 
following list of keywords is in alphabetical order. 


ANNOUNCE/ string/ 


Enables you to display prompts or messages, usually from within FSE 
procedures. The string you specify is displayed in the FSE message area 
before the next input is accepted. 


CHAR character 
Sets the specified punctuation character as the soft tab character. 
If you want to specify the semicolon, use SEMI. 
If you want to specify the blank character, use BLANK. 


If you want no soft tab character (as is often appropriate when screen 
editing), specify SET CHAR either with no parameter or followed by a 
semicolon. 


FILENAME file 


Changes the name of the current file. Using this parameter, you can 
change a file and then have FSE copy the changed version to a new file, 
keeping the original file intact. 


HEADER value 


Tells "SE how to display the title line. If value is YES, FSE displays the & 
entire title line (also the default). If value is NO, FSE abbreviates the title 
line to the file name. 
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S} INCREMENT number 


Sets the line number increment for lines inserted into BASIC or 
interactive FORTRAN sequenced files. The default increment is 100. For 
information on sequenced files, refer to the NUMBER keyword. 


@ KEY number SHIFT string LABEL string 


Redefines a programmable function key to execute the directive or 
directives you specify with the string parameter. 


number is a number from 1 through 16 (the numbers of the function keys). 


Including the SHIFT parameter defines the shifted function key (you can 
define up through 32 functions). 


To separate directives, use a semicolon. The following SET KEY directive 
redefines function key F1 to execute the LOCATE NEXT and VIEW 
directives. 


SK 1/L N;V 


To return a function key to its default setting, enter only the number 
parameter. 


SK 1 


@ If you do not include the LABEL and string parameters, the key label is 
the same as the directive string. If you do not include the directive string, 
but do include the LABEL and string parameters, the label changes but 
the directive executed by the key remains the same. The directive string 
can be 244 or fewer characters; the label string can be 6 or fewer 
characters. For example, the following default function keys for the 
Viking 721 terminal are set as follows: 


S K 1/8 M/L/MARK/ 
SK 2/M M T P/L/MOVE 
SK S 2/C MT P/L/COPY/ 


Function key Fe QW scan be redefined to move lines after instead of 
before the current line by entering: 


SK 2/M M/ 


rd You can include blanks in a function key label to make the label more 
readable. A good rule is to leave a space before labels of five or fewer 
characters. 
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LINE 


Sets line mode for the current editing session; it does not affect other 
editing sessions or other parts of your terminal session. Line mode is set 
either by default or by entering a NOS LINE command before starting 
FSE. 


MARK range WORD 
Sets one or two temporary markers to be used with another directive. 


When you are screen editing, the SET MARK directive performs the same 
function as the F1 key, while the SET MARK WORD directive 
performs the same function as F1 Mai. Refer to section 2, Screen 
Editing, for an example using the F1 REGY@ key. 


By default, SET MARK marks an entire line or range of lines. You can 
then refer to these lines in a later directive by using the MARK 
parameter. For example, 


SM 5 10 
marks lines 5 through 10. Later, the directive: 
CM T 50 


copies lines 5 through 10 immediately after line 50. 


SET MARK is frequently used in screen editing to mark the current line 
for later copying, moving, and so forth. A single SET MARK directive 
marks the current line. A second SET MARK directive marks the current 
line and all lines between the first and second marks. 


The WORD parameter has two effects. The first causes characters to be 
marked instead of lines. The second causes any later operations using the 
MARK parameter to perform character-oriented operations instead of 
line-oriented operations. For example, the word character is marked in the 
following text. 


The @ikislaaia mark causes later operations to affect only 
characters within Lines. 


A DELETE MARK directive results in: 


The:=mark causes later operations to affect only characters 


within Lines. © 


The UNDO directive first clears any previously set marks. 
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é NUMBER value 


Instructs FSE whether to treat a file as sequenced or unsequenced. The 
values are: 


value Function 


AUTO Instructs FSE to treat the file as if it were unsequenced 
(default). In line editing, FSE automatically generates line 
numbers when lines are displayed. These numbers are 
provided for reference and are not part of the text of the file. 


BASIC Instructs FSE to assume that the file is sequenced. If you are 
creating a file and you number the lines, FSE adds zeros to 
increase the number to five digits and automatically inserts 
a blank. For example, when you type 10The first Line, 
the line is printed as: 


00010 THE FIRST LINE 


If you don’t number the lines, for example The first Line, 
FSE prints only the text (without a line number). 


THE FIRST LINE 


If you insert text using the INSERT directive, FSE 
automatically generates a sequence number. For lines added 
to the end of a file, it adds 100 to the last number. For 
example, assume the following lines are the last two lines in 
a file. 


00010 THE FIRST LINE 
00020 THE SECOND LINE 


If you position the cursor at line 00020 (the last line) and use 
the INSERT directive to specify I the new Line, FSE 
writes: 


00010 THE FIRST LINE 
00020 THE SECOND LINE 
00120 THE NEW LINE 


For lines inserted between existing lines, FSE adds half the 
value of the preceding line. If you position the cursor at line 
00010 in the preceding example and follow the same 
procedure, F'SE prints: 


QO0010 THE FIRST LINE 
00015 THE NEW LINE 
00020 THE SECOND LINE 


Revision B FSE Directives 4-53 ¢ 


value Function 


FORTRAN The same as BASIC except that it doesn’t insert a space 
between the line number and the first character. 


NONE Instructs FSE to treat the file as if it were unsequenced. 
When line editing, FSE displays lines without generating 
line numbers. 


PROMPT value 


Enables you to specify whether you want the programmable function key 
prompts to be displayed on the screen. Values can be: 


value Description 

0 Instructs FSE not to display programmable function key 
prompts. 

1 Instructs FSE to display the first eight programmable 
function key prompts (default). 

Z Instructs FSE to display all 16 programmable function key 
prompts. 

SCREEN 


Sets screen editing mode and rewrites the screen if you are already in 
screen mode. 


TAB col, coly col 3..col x9 


Sets the tab stop at the specified column number (col,,). Default tab 
settings are 7 and 72. You are allowed up through 20 tab settings. If no 
column numbers are specified, all tabs are cleared. You cannot add tabs to 
existing tab settings. For example, if you need to add a tab at column 15 
between 7 and 72, enter: 


ST 7 15 72 


When you are screen editing, FSE sets a hardware tab at column 1, 
allowing you to use the key to position the cursor at the beginning 
of the line. This does not affect the SET TAB values. 
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& UNDO value 


Sets the UNDO feature on or off. Values can be YES or NO. YES enables 
you to use the UNDO directive as described previously in this section. 
When you specify NO, you cannot use the UNDO directive. However, 
with the UNDO feature off, massive changes to files use less system 

© resources and complete more quickly, which is particularly important if 
you are doing batch processing. The default is YES. 


VIEW value 


The SET VIEW directive enables you to change the format of your screen. 
Valid value entries are: 


value Function 


COLUMN num _ Specifies the number of columns (num) to be displayed. 
The default is 80 columns. SET VIEW COLUMN isa 
hardware option, not a software option. It tells your 
terminal to display the number of columns you specify. 
For example, on a Viking 721 terminal, SET VIEW 
COLUMN 81 sets the terminal to 132-column mode, and 
all 182 columns of text are displayed. 


EDIT num Defines a column width (num) of text that can be edited. 
The number specified is always the right margin and 1 
© is always the left margin. For example, to limit yourself 


to editing only columns 1 through 20, enter 20 as the 
EDIT value. Any column following column 20 will not 
be affected by succeeding edit functions. 


LINE num Specifies the number of lines (num) to be displayed. The 
default is the capacity of your terminal. 


OFFSET num Changes the leftmost column displayed so you can view 
wide lines. num represents the column number of the 
new left margin. To return to the default column range 
of 1 through 72, enter: 


§V01 
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value Function 


SPLIT num Specifies the number of lines (num) used for the bottom 
half of a split screen edit. The default is one-half the 
capacity of your terminal. 


WARN num Specifies a line length limit. The default limit is 160. If, 
in the course of directive processing, a line is 
encountered that exceeds the SET WARN limit, 
directive processing stops and a warning message is 
displayed. 


Refer to Changing Your Screen’s Format in section 6 for more examples 
of SET VIEW directives. 


WORD value 


The SET WORD directive enables you to set character attributes and 
specify margins. Valid value entries are: 


value Function 


CHAR character Defines the character attribute as 
alphanumeric or punctuator. The directive 
reverses the current attribute of the 
indicated character and issues a status 


message to the user. © 


A space cannot be redefined. It is treated as 
a filler and punctuator for the DELETE 
WORD option. 


The semicolon can be redefined using the 
directive: 


S WC SEMI 


The character attribute value affects the 
UPPER and WORD options of the 
LOCATE and REPLACE directives, the 
WORD option of the DELETE directive, 
and the &W micro symbol. 
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value Function 


The UPPER option of the LOCATE and 
REPLACE directives will accept the 
following pairs of lowercase to uppercase 
mappings (provided both characters have 
been defined by aS W C directive as 


alphanumeric). 
{ C 
} J 
\ 
\ a) 
FILL margin1 margin2 Sets margins other than the default settings 
margin3 (1, 65, and 5) for use with the .CENTER and 


.FILL directives. margin] sets the left 
margin; margin2 sets the nght margin; and 
margins sets the paragraph indentation. 
Refer to section 5, Sample Screen Editing 
Session, for examples of word processing 
functions. 


X line WORD 

Y line WORD 

Z line WORD 
Sets the X, Y, or Z pointer to the specified line value. These pointers can 
be used in any directive in which a line parameter is allowed. If two 
pointers are specified in a range parameter, they must be in the same file. 


These pointers are permanent (as compared with those set by the MARK 
function) and can be reset at any time. 


The WORD parameter sets the pointer to a character position rather than 
a line value. Any subsequent directives that use a pointer directive are 
character-oriented rather than line-oriented. Refer to the SET MARK 
directive for more information. 
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TEACH 


Provides a practice file on which you can try some of the FSE operations. If 
you have a Viking 721 terminal, the file also includes a tutorial, which guides 
you through the basic editing functions. 


Without Parameters 

If you enter TEACH with no parameter specified, the cursor is positioned to 
the first line of the TEACH file. 

Format 


TEACH parameter 


Parameters 


The parameters are titles of topics. When you specify a parameter (applicable 
only to Viking 721 terminals), the cursor is positioned at the first occurrence 
of the topic in the TEACH file. If you enter an invalid parameter, the cursor 
is positioned at the beginning of the TEACH file. Valid parameters are: 


BKSPACE LOCATE F1 
BKTAB LOCNXT SHIFTF1 
BKW MARK F2 
CENTER MOVE SHIFTF2 
COPY MRKCHR F5 
CURSOR NEXT F6 
DLETE PARA F7 
SHIFTDL QUIT SHIFTF7 
ENDLIN REPLACE F8 

FWD SHIFT SHIFTFS8 
HOME SPLIT F10 
INSRT TAB F1l 
SHIFTIN UNDO F12 
JOIN WORDPRO F13 
KEYS 132COL F15 


4-58 FSE User’s Guide Revision B 


° Remarks 
To return to the file you were editing, press: 


Unlike the HELP file, the TEACH file is not protected. Its purpose is to 
rd] teach you how various features work, and you are encouraged to change it as 
much as you like. 


The tutorial accessed for the Viking 721 terminal does not cover every 
feature of FSE. Its purpose is to acquaint you with the basics of screen 
editing. 
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UNDO 


Undoes changes made to the current file. 


Format 


UNDO @ 


Remarks and Examples 


Successive UNDO directives work backward in chronological order to 
restore the file to previous conditions. For example, suppose you made the 
following changes to the current file in the order shown. 


1. Replaced all a’s with b’s. 
2. Moved the first three lines of the file to the end of the file. 
3. Changed a line of text by overtyping the correction. 


The first time you enter UNDO, the changed line of text is restored to its 
original form. 


The second time you enter UNDO, the three lines now at the end of the file 
are returned to the beginning of the file. 


The third time you enter UNDO, the b’s are restored to a’s. 


If you have pressed F1 QZGY@ or entered the SET MARK directive to mark 
lines, the first UNDO removes the marks and nothing else. A message is 
displayed telling you that the marks have been removed. The next UNDO 
will then work as shown previously. 


UNDO can undo your changes if you exit FSE using the QUIT or QUIT 
REPLACE directives; just enter the FSE command without parameters and 
enter UNDO as many times as needed. 


You can think of the UNDO directive as a type of security blanket. If you 
can’t quite recall how a directive works, give it a try anyway. If you don’t 
like the results, you can undo them. 
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VIEW 
@ = 


Allows you to view a group of lines. 


e Without Parameters 


SS 


If you do not specify a parameter while line editing, the four preceding lines, 
the current line, and the four succeeding lines are displayed. If you do not 
specify a parameter while screen editing, the current line is centered 
vertically on the screen. 


Format 


VIEW line direction SCREEN HOME 


Parameters 
line 


Specifies the line you want to view. (This is a common parameter. For a 
list of possible entries, refer to the Common Parameter Index on the inside 
front cover.) 


@ direction 


Specifies the direction you want to view. The direction parameter can only 
be NEXT or PREVIOUS (described in Common Parameters, earlier in 
this section). 


When you are line editing, the VIEW directive enables you to look ata 
number of lines at once. The following are valid line mode VIEW 
directives. 


Entry Meaning 


V Displays the current line, the four preceding lines, and the four 
succeeding lines. 


VN __ Displays the current line and the next eight lines. 
VP Displays the previous eight lines and the current line. 


©} Successive VIEW NEXT or VIEW PREVIOUS directives page through 
the file. 
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SCREEN 


Available only when screen editing, enables you to view the previous or 
next screen. 


HOME 


Available only when screen editing, moves the cursor to the FSE directive e 
line without changing your view of the file text. 
Examples 


When you are screen editing, VIEW is used to position text on the screen. 
The following are valid screen mode VIEW directives. 


Entry Meaning 


V Vertically centers the current line on the screen. 

VN Positions the current line at the top of the screen; same as the 
key. 

VP Positions the current line at the bottom of the screen. Same as 


the key. 
VNS Moves forward one screen; same as the key. 


VPS Moves backward one screen; same as the key. 


VH Moves the cursor to the directive line; same as the key. 
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. (DOT) 


Performs word processing functions according to the specified parameter. 


Format 


._parameter 


Parameters 
CENTER 


Centers the current line horizontally within preset margins. The default 
margin settings are 1 and 65. Use the SET WORD FILL directive to 
change these margins. 


DELETE 
Deletes the current character. 
END 
Moves the cursor to the end of the current line. 


S$ FILL 


Adjusts the words or sentences within a paragraph of text to bring line 
lengths as close as possible to preset margins. A paragraph of text is a 

group of lines that does not contain a blank line. Margin defaults are 1, 
65, and 5. Use the SET WORD FILL directive to change these margins. 
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INSERT 


Inserts one blank character at the current cursor position. 
INSERT/ string 

Inserts a string at the current cursor position. 
JOIN 

Combines the current line with the line following it. 
POS n 

Moves the cursor position to column n of the current line. 
SPLIT 

Divides one line into two. The line is split at the cursor position. 
NOTE 


During line editing, only the .CENTER and .FILL directives function visibly 
as indicated. The other functions work, but you will not see the results until 
the file is listed. For this reason, they are not very useful for line editing. For 
more information on word processing functions in line editing, refer to 
section 7, Line Editing. 
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@ - (DASH) 


Calls an FSE procedure. An FSE procedure is one or more directives in a 
named record in a file. More information on FSE procedures follows the 
parameter descriptions. 


Format 


-procname (file) 


Parameters 


procname 
The name of the FSE procedure you want to execute. 
(file) 


Calls a procedure from a local or permanent file other than the default file 
FSEPROC. You always have an FSEPROC file; if there is no local file 
named FSEPROC, a NOS GET command is executed. If there is no 
indirect access FSEPROC file, a system default FSEPROC file is retrieved 
from the user name LIBRARY. 


_ To call procedure FIND from local file PROCFIL, enter: 


-FIND (PROCFIL) 


FSE goes to file PROCFIL and executes the FIND procedure. 
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Remarks 


An FSE procedure must begin with its name alone on the first line, followed 
by one or more lines of FSE directives. The procedure must then end with 
either an end-of-record (HOR) line or a QUIT PROC directive. You cannot 
leave blank lines or comment lines between procedures. For example, the 
following two procedures delete all lines containing a specified string. 


DELALL 

S A/DELETE WHAT?/ 
L F/&?/; -DA 

QP 

DA 

D>L;-DA 

CEOR) 


Assuming these records are in your FSEPROC file, you can call the first 
procedure by entering: 


-DELALL 


The procedure then prompts you with DELETE WHAT?. You enter a string 
and all lines in the current file containing that string are deleted. 


Each directive in a procedure is executed in sequence. If a directive attempts 
to position the cursor outside the current file or to locate a string that does 
not exist, FSE stops executing that line of the procedure and continues with 
the next line. FSE returns to your editing session whenever it encounters 
(EOR) or a QUIT PROC directive. 


Procedure calling is only one-level deep; that is, the - directive jumps to the 
named procedure, terminating the execution of any current procedure. 


The procedure named STARTUP in FSEPROC is executed each time you 
start FSE, but not when you resume a previous session. You must create 
your own STARTUP procedure. 
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When certain two-character sequences, called micros, are contained in FSE 
procedures or programmable function key strings, FSE interprets them in a 
particular way. They are not interpreted when they are entered as directives 
or when they are within your files. 


@ oe A a a ee ee 
&C 


The column number of the current character position beginning at 
1. 


&F The name of the current file. 
&L The number of the current line beginning at 1. 
&T The current terminal type (721, 722, VT100, Z19, and so forth). 


& W The word on which the cursor is positioned, or, if the cursor is not 
positioned on a word, the next word to the right. 


&n The nth parametert of a procedure call, for example, &2. 
&? A prompt for you to enter input (your input replaces the &?). 
&& & 


For example, suppose you have a procedure in FSEPROC defined as: 
© FCOMP 
/FTNS , 1=&F,L=0. 


QP 


, + In a procedure, a parameter consists of either a series of nonblank 
& characters or a string. 
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To compile the current file as a FORTRAN 5 program, you enter: 


-FCOMP 


For added convenience, the procedure can be assigned to a programmable 
function key. To define the F9 key as -FCOMP, enter: 


S K 9 /-FCOMP/L/FORT/ 
Whenever you press: 
F9 
the current file is compiled as a FORTRAN 5 program (FCOMP). 


Procedure parameters are taken from the directive that calls the procedure. A 
parameter is a consecutive sequence of nonblank characters or a string. For 
example, in the following procedure call: 


-XYZ /hi there/ bye now 


micro &1 within procedure XYZ is replaced by /hi there/; &2 is replaced by 
bye; and &3 is replaced with now. 


Refer to section 6, Advanced FSE Functions, for more examples of FSE 
procedures. 


NOTE 


If you use a procedure to redefine a function key with a micro, the 
ampersand contained in the micro must be written twice. At the time the 
procedure is executed, the double ampersand is reduced to a single 
ampersand and stored in the function key. When the function key is pressed, 
the single ampersand and letter are identified as the correct micro. 


Failure to double the ampersand in the procedure results in the micro being 
processed at start up time rather than when the function key is pressed (that 
is, you will have redefined the key incorrectly). 
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@ -- (COMMENT) 


Enables you to include comments following FSE directives. 


& Format 


-- comment 


Example and Kemarks 


comment is the remark you want to make after an FSE directive, for 


example: 
LLe 
-- Locate last two procedures 
S A/LAST TWO OF WHAT?/ -- Prompt user 
LL P 2/&?/ -- Locate specified string 
QP 


These comments have no effect. 
NOTE 


i Comments cannot appear on the line containing the procedure name, the 
QUIT PROC directive, or the (EOR) line. 
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/ (SLASH) 


Exits FSE and executes the characters following the slash as a NOS 
command. 


NOTE & 


Some NOS commands will not work with the / directive. These include LIB, 
NOSORT, RUN, the -procname format of the BEGIN command, and 
primary file editing commands (refer to the NOS 2 Reference Set, Volume 3). 


Format 


/command 


Examples and Kemarks 


command is the NOS command you want to execute. For example, to enter 
the NOS CATLIST command while you are editing a file, enter: 


/CATLIST 


To reenter your editing session at the point you entered the NOS command, @ 
enter the FSE command with no parameters. 


FSE 


If the / directive is used to execute a NOS procedure that ends with the 
following command, the procedure automatically reenters when it is finished. 


REVERT, EX.FSE. 


The / directive is simply shorthand for the QUIT directive with a string 
parameter. That is, 


/command 
is equivalent to: 
Q/command 


You can use the Q/command format to specify other QUIT parameters. For 


example, og 


QR/FSE 


replaces all changed files and restarts FSE. 
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Sample Screen Editing Session 5 
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Restarting FSE 


Sampie Screen Editing Session 5 


In this section, sample files will be edited using some of the advanced screen 
editing functions, including: 


e Copying lines between files using split-screen editing. 
e Performing word processing functions. 
e Changing your screen’s format. 


Use this section to familiarize yourself with the editing functions available. 
The editing session does not include all of the advanced functions; for a 
comprehensive description, refer to section 6, Advanced FSE Functions. 


NOTE 


For each task, sample display screens will show you how an imaginary file 
would look before and after editing. The sample files are not released with 
the system. You must create your own sample files if you want to perform the 
tasks in the examples. 
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Starting FSE 


Suppose you want to edit file MYFILE. To start FSE and get your file out of 
permanent storage, enter: 


FSE,MYFILE,G © 


The file is displayed on the screen. 


Notice that the prompt for function key F6 is not the default described in 
section 2. The default setting: 


om QUIT ® 


has been redefined to include the shifted F6 function QUIT REPLACE, 
abbreviated QR. (Redefining programmable function keys is described in 
section 6.) 
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@ Copving Lines Between Files 


To copy lines from file MYFILE to another file (PARTS), use split-screen 
editing. 


@ First, display file PARTS on the lower half of the screen by pressing: 
and entering the FSE directive: 


F PARTS AS 


A specifies 6/12-bit ASCII characters, and S specifies a split screen. The 
following screen results. 
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Then, position the cursor at the first line of the range to be copied. 


Press: 


ee MARK | 
FSE highlights the marked line. 


IMPLICIT INTEGER (A-Z) 
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& Then, move the cursor to the last line of the range to be copied. 


IMPLICIT INTEGER (A-Z) 


Press: 


ae MARK) 
again and FSE highlights the range of lines marked. 


IMPLICIT INTEGER (AZ) 
PARAMETER (PRM=1,PRMC=2,SEC=3,SECC=4,TER=5,TERC=6) 
PARAMETER (MSC=5O) 


PARAMETER (MAXILEN=160,MAXSLEN=310,MAXOLEN=160) 
& CHARACTER*40 COND 
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Next, move the cursor to the point in file PARTS at which the lines from file @ 
MYFILE are to be inserted. 


PARAMETER (PRM=1,PRM 
PARAMETER (MSC=5Q) = 
PARAMETER (MAXILEN=160,MAXSLEN=310,MAXOLEN=160) | 
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© Press: 


(<) F2 
to insert the lines in file PARTS. 


LOCNXT | 
LOCATE #8 


To return to editing file MYFILE only, press: 
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Word Processing 


To edit a different permanent file (TEXT), created in the 6/12-bit ASCII 
character code set, you would press: 


and enter: 


F TEXT AG 


LOCNXT 
LOCATE 
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) Our editing example requires the use of the function key prompts that 
@ contain some of the word processing functions. To display the additional 
prompts, press: 


& and enter: 


SP 2 
which stands for: 
SET PROMPT 2 


FSE displays all 16 function key prompts. 


QR LOCNXT 80COL 
UNDO fey QUIT PALOCATE [eg 132COL 
ae MIDDLE oe JOIN BM PARA 1 A; CENTER mA 


MRKCHR 


COPY DELB 
imme 6MARK fig MOVE fag INSB BA FIRST [Sy 


LAST 
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To insert a paragraph between the first and second paragraphs, position the ® 
cursor between them and press: 


F3 EXE} 


(A paragraph is a group of lines that does not contain a blank line.) 


This document is intended to provide background information to add to @ 
the body of knowledge provided by the Help file. You should read and 
understand the entire Help file as a prerequisite to using this study 
guide. 


This document is simply organized as topics, like the help file. If 
you assign this file as either FSEHELP or FSTEACH, then you can use the 
topic-search capability of the HELP or TEACH command. 


FSE inserts blank lines over which you can type your new paragraph. 
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@ Then, type the new paragraph. 


To access the HELP file, press HELP or enter the HELP directive | 
described in the FSE manual. Further HELP is available in this file. 


Position the cursor anywhere in the new paragraph and press: 


@ mmemPARA 


to ensure that the lines conform to the boundaries set by the SET WORD 
FILL directive (defaults are 1, 65, and 5). 


To delete the unused blank lines, press: 


(S)F3 
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To enter a heading above the new paragraph, position the cursor at the first @ 
line of the paragraph. 


© To access the HELP file, press HELP or enter the HELP directive 
described in the FSE manual. Further HELP is available in this file. 


Press: @ 
S) 


twice. Then enter the heading. 


Paragraph Number 2 = 


To access the HELP file, press HELP or enter the HELP directive 
described in the FSE manual. Further HELP is available in this file. 


To center this heading, position the cursor anywhere on the heading line. 
Paragraph Number 2 © 


To access the HELP file, press HELP or enter the HELP directive 
described in the FSE manual. Further HELP is available in this file. 


Press: 


mbm CENTER 


Paragraph Number 2 @ 


To access the HELP file, press HELP or enter the HELP directive 
described in the FSE manual. Further HELP is available in this file. 


To return the screen to displaying only the first line of programmable 
function key prompts, press: 


and enter: 


SP 1 
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¢ Changing Your Screen’s Format 


You might prefer to display a smaller number of lines on the screen than the 
default number. For example, to limit the screen to only 14 lines, including 
; the file header and function key prompts, press: 


and enter the SET VIEW LINE directive. 


SVL 14 


The first screen for file TEXT would then appear as: 


The remaining space on the screen is left blank and is not used by FSE. 
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Stopping FSE 


To stop FSE and make the changes to files TEXT and PARTS permanent, 
enter the QUIT REPLACE directive by pressing: 


(<>)F6 GA 


The following messages appear. 


FILE: MYFILE (NO CHANGES) 
FILE: PARTS (PERMANENT) 
FILE: TEXT (PERMANENT) 
FILE: FSEPROC (NO CHANGES) 
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@ Restarting FSE 


During a terminal session, you can return to editing a file at the exact spot 
you left it by restarting FSE. For example, to return to sample file TEXT, 


enter: 
2 FSE 


The screen appears just as you left it. 
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You can then continue editing. For example, to delete the paragraph 
heading, position the cursor on the heading line and press: 


S) GET) 


Press: 


(S) Grete) 


again to remove the extra blank line. The following screen results. 


LOCATE 


Enter: 


: @ 


or press: 


(<)F6 GH 


(if you have redefined it) to stop FSE and make the change to file TEXT 
permanent. © 
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Advanced FSE Functions 6 


This section describes the following advanced features of FSE. 


Editing two files at the same time. 


e Creating and using FSE procedures. 


@ NOTE 


You should be familiar with the directives before you attempt to create FSE 
procedures. 


Redefining programmable function keys. 
Labeling programmable function key prompts. 
Procedure branching. 


Changing your screen’s format. 


NOTE 


For each task, sample display screens will show you how an imaginary file 
would look before and after editing. The sample files are not released with 
the system. You must create your own sample file, if you want to perform the 
tasks in the examples. 
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Editing Two Files at the Same Time 


In screen editing mode, FSE allows you to simultaneously display two 
different files or two different parts of one file. To do so, you must enter the 
FSE directive with the SPLIT parameter. For example, suppose you are 
editing file MYFILE, and you also want to edit permanent file TEXT in 
ASCII mode. Enter: 


F TEXT AG S$ 


FSE splits the screen, displaying file TEXT in the bottom half of the screen 
in CDC 6/12-bit ASCII code. 


LOCNXT 


You can edit and page through the two files independently of each other. For 
example, if the cursor is positioned within the MYFILE text area and you 
press , only file MYFILE is advanced one page. 
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To display different parts of the same file, specify the name of the current file 
on the FSE directive with the SPLIT parameter. For example, to display 
different parts of file MYFILE at the same time, enter: 


F MYFILE S$ 


FSE splits the screen, showing a copy of the first page of file MYFILE on the 
bottom half of the screen. Changes you make to one copy of the file are made 
simultaneously to the other. 


You can page through each copy independently by positioning the cursor in 
the copy you want to edit. In the sample screen below, the first page of 
MYFILE is on the top half; another part of file MYFILE is on the bottom 
half. 
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Creating and Using FSE Procedures 


FSE enables you to create procedures containing any of the FSE directives 
described in section 4. Each procedure is usually contained on a separate 
record within a file named FSEPROC. If you do not have a local file or a 
permanent file by that name, FSE accesses a site-defined version of it and 
makes it local each time you start. You may alter this copy and save it to be 
used during editing. 


The first line of each procedure must be the procedure’s name (from one 
through seven characters). Procedures must be separated by either an end-of- 
record (EOR) statement or a QUIT PROC (QP) directive. For example, an 
FSEPROC file could contain the following procedures. 


STARTUP 

SK 5 S/LP/ 
C(EOR) 

PROC1 

S K 1 S/LP/ 
QP 

PROC2 

LN;V 

QP 


NOTE 


Because a record requires a minimum of one PRU, using the QP directive to 
separate procedures may save disk space. 


To execute the procedures within FSEPROC, use the - (dash) directive. For 
example, you have the following procedure on file FSEPROC. 


PROC1 
SK 6 S/L N 2/ 
QP 


To execute PROC1 enter: 
—-PROC1 


FSE goes to file FSEPROC and looks for procedure PROC1. When PROC1 is 
executed, the shifted F'6 key is redefined to execute the LOCATE NEXT 2 (L 
N 2) directive. 
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To call a procedure from a local or permanent file other than FSEPROC, 
& include the other file name in parentheses. The following example executes 
procedure SEARCH from file ALTFILE. 


-SEARCH CALTFILE) 


@ If you have certain functions you want executed every time you start FSE, 
use the procedure name STARTUP in your FSEPROC file. Each time you 
start (but not restart) FSE, it looks for the record named STARTUP on 
FSEPROC and executes the FSE directives. 


For example, to redefine the shifted F5 key as the LOCATE PREVIOUS 
function, create the following procedure. 


STARTUP 
SK 5 S/ LP/ 
QP 


Each time you start FSE, the STARTUP procedure redefines the shifted F5 
key. 


NOTE 


To greatly increase the efficiency and speed of batch processing operations, 
move the procedures that will be used most often to the beginning of 
FSEPROC (or your own procedure file). 
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SET ANNOUNCE Directive 


The SET ANNOUNCE directive enables you to specify, within a procedure, 
the prompts or messages to be displayed on the right side of the FSE 
directive line. 


For example, suppose you have a procedure called TOP that appears as: 


TOP 
P 1 
QP 


This procedure positions you at the first line of a file. If you want the 
message: 


FIRST LINE OF THE FILE 


to be printed each time this procedure is executed, add the following line to 
the procedure. 


S A/FIRST LINE OF THE FILE/ 


From now on, every time you use the TOP procedure to go to the first line of 
a file, 


FIRST LINE OF THE FILE 


is printed in the message area of the FSE directive line. & 


This message disappears when you perform the next function. The 
maximum message length is 40 characters. Refer to section 4 for more 
information on the SET directive. 
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e Micros 


Micros enable you to specify the current character, word, line, or file as a 

parameter either in an FSE procedure or in a directive string assigned to a 
programmable function key. You can also create your own prompts for input 
or specify different parameters each time you call a procedure. These micros, 
all preceded by an ampersand (&), are: 


Micro 


&C 
&F 
&L 
&T 


&W 


Function 

Specifies the current column number. 
Specifies the current file name. 
Specifies the current line number. 


Specifies the current terminal type (Viking 721, CDC 722, VT100 
and so forth). 


Specifies the word on which the cursor is positioned, or, if the 
cursor is not positioned on a word, the next word to the right. 


Specifies the nth parameter of a procedure call. 
Enables you to enter procedure parameters interactively. 


Specifies an ampersand (&). 


Specifying the Current Column Number (&C) 


To specify the current column number, use the &C micro. For example, the 
following procedure uses the current column number as the parameter in a 
SET VIEW OFFSET directive. 


COL 


S VO &C 


QP 


When you enter: 


-COL 


the current column number becomes the left margin on the screen. 
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Specifying the Current File (&F) 


To specify the current file, use the &F micro. For example, the following 
procedure compiles the current file as a FORTRAN 5 program, no matter 
what the current file is. 


FTN 
/ FINS , I=&F,L=0. 
ap 


Each time you enter: 
-FTN 


the current file is compiled as a FORTRAN 5 program. To return to the point 
in the file where you entered -FTN, enter: 


FSE 


Specifying the Current Line (&L) 


To specify the current line of a file, use the &L micro. For example, the 
following procedure copies the current line to end of the file. 


CPYL 
COPY&L TO LAST 
QP 


When you enter: 
-CPYL 


the current line is copied to the end of the file. 
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Specifying the Current Terminal Type (&T) 


To create a procedure whose execution depends on the type of terminal being 
used, use the &T micro. For example, using this micro you can create the 
following STARTUP procedure, which calls a second procedure based on the 
current terminal type. 


STARTUP 

—-XX&T 

QP 

XX721 

S K S 6/GET STATUS/ 

S A/STATUS IS ON SHIFT-F6/ 
QP 

XX722 

S K S 9/GET STATUS/ 

S A/STATUS IS ON SHIFT-F9/ 
QP 


The STARTUP procedure automatically changes the keyboard functions, 
depending on whether a Viking 721 or a CDC 722 terminal is being used. 


Specifying the Current Word (&W) 


To specify the current word of a file, use the &W micro. For example, the 
following procedure locates the next occurrence of the current word and 
centers vertically on the screen the line containing it. 


NW 
L N/&W/ ;V 
QP 


If the cursor is positioned at the word INTEGER and you enter: 
—NW 


FSE locates the next occurrence of INTEGER and centers the line in which it 
appears. 
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Specifying the nth Parameter of a Procedure Call (&n) & 


To specify different parameters for a procedure each time the procedure call 
is used, use the &n micro (n is the number of the parameter you want to 
specify). For example, the following procedure is on FSEPROC. 


TOEND © 
C 8&1 &2 TOL 
ap 


This procedure copies the range you specify to the end of the file. Using this 
procedure, you can copy lines 20 through 30 to the end of the file by entering: 


-TOEND 20 30 


The next time you can specify a different range by including it on the call to 
the TOEND procedure. 


Entering Parameters Interactively (&?) 


To create a procedure that prompts you for input, use the &? micro. For 
example, the following FIND procedure prompts you to enter the string you 
want to find and then centers the line containing the string. 


FIND 
L/&?/7V @ 
QP 


When you enter: 


-FIND 
the prompt: 
<--- ENTER TEXT 


appears in the FSE message area. If you then enter DATA, FSE locates the 
next occurrence of DATA and centers the line containing it on the screen. 


ENTER TEXT is the default prompt. To create your own prompts, include a 
SET ANNOUNCE directive in your procedure before the directive containing 
the &? micro. For example, to create the prompt FIND WHAT? in the FIND 
procedure, insert the SET ANNOUNCE directive as follows: 


FIND 
S A/FIND WHAT?/ @ 
L/&?/;V 


QP 
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Now when you enter: 
-FIND 


you are prompted with FIND WHAT? instead of ENTER TEXT. 


Micro Values 


You may write a procedure in which the value of a micro changes within the 
procedure, as for example in: 


PROC 1 
.P3 
-P&C+4 
-P&C+7 
-P&C+3 
QP 


FSE changes the value of the &C micro (which represents the current 
column) at the end of each line of the procedure and, therefore, positions 
itself sequentially at columns 3, 7, 14, and 17. 


The procedure just described has only one directive per line. Suppose that 
you wrote a procedure using the same directives, but combined two of the 
directives onto one line. 


PROC 1A 

-P3 

-P&C+4; .P&C+7 
-P&C+3 

QP 


Although the directives are identical, the results of the two procedures are 
different: PROC IA positions FSE at columns 3, 10, and 13. Part of the 
reason for this difference is that FSE interprets all the micros on a line 
before it processes the directives. As a result, each occurrence of a particular 
micro on a line is interpreted the same. In PROC 1A, FSE positions itself at 
column 3 at the end of the first line. It then interprets both of the micros in 
the second line as 3. 


The different results occur for another reason. When more than one directive 
on a line is associated with the same micro, FSE uses the final directive as 
the determining value. In PROCI1A, it uses the last directive on the line and 
positions itself at column 10. 
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Procedure Looping 


Within FSE, you can create a procedure that repeats itself as long as certain 
conditions are met. This is called procedure looping. 


Following are two versions of an identical procedure, both of which create 
loops, but only one of which functions correctly. 


Version A Version B 
PROC 1 PROC 1 
-P&L+1;R/abc/xyz/;-PROC 1 .P&Lt1 
QP R/abc/xyz/ 
-PROC 1 
QP 


In both versions of this procedure, the position of the current line will be 
increased by 1; abc will be replaced with xyz; and the recursive procedure call 
(a procedure call to itself) will cause the same procedure to be executed again. 


The versions differ in that version A of the procedure provides for an 
eventual exit from the procedure, while version B causes an infinite loop. 


The reason lies in the way FSE executes directives that occur on the same 
line of a procedure. If it is unable to execute a directive, it ignores all the 
following directives on that line, and immediately proceeds to the next line. 
In version A, if it cannot execute either the position or replace directive, it 
will skip the recursive call and execute the quit procedure directive. 


In version B, if it is unable to execute these directives, it will proceed to the 
recursive call and never reach the quit procedure directive. 


The general rule to remember is that if you have a recursive call toa 
procedure, place the exit condition on the same line as the recursive call. 
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Conditional Procedures 


The execution of conditional procedures depends on the occurrence of a 
specific condition or event (for example, the end of the file, x being greater 
than y, or the location of specific characters). The following examples 
illustrate the three methods available for writing conditional procedures. 


Example 1 


You can use the LOCATE or REPLACE directive. 


Procedure Description 

FNNDEL Procedure name. 

L/go away/;D;PN;-FNNDEL Delete all lines containing the phrase 

PF go away, beginning with the current 
CEOR) one. After all the lines have been deleted, 


return to the first line. 


Example 2 


You can combine directives and line addresses. 


Procedure Description 

DELALT Procedure name. 

D;PN;PN;-DELALT Delete the current line and advance one 
CEOR) line if possible. Advance a second line if 


possible. If both line advances have occurred, 
repeat the procedure. 
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Example 3 


You can use the QUIT PROC directive to explicitly terminate a procedure. 
This can be accomplished using either no, one, or two parameters. 


Using No Parameters 


Procedure Description 

DELCUR Procedure name. 

LCC/don't shoot/;QP Search for the phrase don’t shoot on 

D the current line. If successful, go 

QP to QP and quit. If not successful, delete the 


line and terminate the procedure. 


Using One Parameter 


The address C+10 is the parameter for this procedure. The procedure will only 
execute as long as there are at least 10 lines remaining after the current line. 


Procedure Description 

DELTEN Procedure name. 

QP c+10 If there are 10 or more lines after 

D the current line, delete the current 

CEOR) line. Otherwise, terminate the procedure. 
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Using Two Parameters 


Here there are two parameters: the value for x and the value for y (which is 
the incremented value of x). The file used must be either ASCII or ASCII 8. 


Procedure Description 


© UPCASE Procedure name. 
QPx y If x is less than or equal to y, 
R/a/A/xx capitalize all the letters in x. 
R/b/B/ xx 
R/c/C/xx 
R/2z/Z/xx 
Sx x+1;-UPCASE If x is still in the file, add 1 
CEOR) to x and repeat the procedure. Otherwise, end 


the procedure. 


Recovering from Errors in FSE Procedures 


If you run a procedure containing an error, FSE accesses the file containing 
& the procedure (FSEPROC or any other file) and positions you at the error. 
For example, assume FSEPROC contains the following procedure. 


LOCPRE 
LP*V 
QP 


The * is not a valid directive separator and will cause an error in the 
LOCPRE procedure. Suppose that while editing file MYFILE, you want to 
locate the previous occurrence of a string and center it on the screen. You 
enter: 


~LOCPRE 
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FSE reads procedure LOCPRE and determines that it contains an error. FSE 
then displays file FSEPROC on the lower half of a split screen and positions 
the cursor at the error. 


LOCNXT 
LOCATE 


You can then correct the error and execute the procedure again. 


If you already have a split screen, the file on the lower half of the screen is 
replaced with the file containing the procedure error. To return to your 
previous edit file, either press: 


or enter the BACK directive. & 
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Redefining Programmable Function 
Keys 


You can redefine the programmable function keys (the default functions are 
described in section 2) to execute any FSE directive. The redefined functions 
remain in effect for the duration of the current editing session. 


To redefine a key, use the SET directive with the KEY parameter. For 
example, to redefine the F6 QUIT key as the QUIT REPLACE function, 


enter: 
S K 6/ QR/ 


FSE then displays the new function key prompts. 


MRKCHR COPY DELB LAST LOCNXT 80COL 
mm MARK Mita MOVE BRS INSB Mme FIRST Eee UNDO ize am LOCATE Ezy 132COL 


NOTE 


Function key definitions must be 244 or fewer characters (only the first 6 
characters will appear on the function key prompt). 


To define or redefine the shifted function keys, include the SHIFT parameter. 
For example, to define the shifted F6 key as the LOCATE PREVIOUS 
function, enter: 


S K 6 S/ LP/ 


FSE then displays the new function key prompts. 
MRKCHR COPY DELB LAST LP LOCNXT 80COL 
im 6MARK Ba MOVE [GBS INSB BS FIRST Ge UNDO —ilee QR [FA LOCATE Eged 132C0L 


To return a key to its default function, enter the SET KEY directive with no 
other parameters. For example, to return the unshifted F6 key to QUIT, 
enter: 


SK 6 


If you want the redefined function keys to remain in effect from one editing 
session to the next, include a SET KEY directive within the STARTUP 
procedure on your FSEPROC file. Refer to Creating and Using FSE 
Procedures earlier in this section for information on the FSEPROC file. 
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Using FSE procedures, it is possible to redefine keys to call procedures. For 
example, you may want to redefine several keys on the first row of function 
key prompts to perform word processing functions. A simple way to do this is 
to create a procedure that redefines the keys you want to use. The following 
procedure illustrates this. 


WORD 

SK 1/ .FILL/ 
SK 3/ I W/ 
SKS 3/ D W/ 
SK S 6/ -DEF/ 
S K 8/ .JOIN/ 
SK S 8/.SPLIT/ 


QP 


Spaces are included in the directive strings to make the function key prompts 
easier to read. 


You then add to your STARTUP procedure the following line, defining the 
shifted F6 key as -WORD. 


S K 6 S/ -WORD/ 


From then on, every time you press: 


(<>) F6 -woRD 


the function keys are redefined to the specified word processing functions. 


6-18 FSE User’s Guide Revision A 


Labeling Programmable Function Key 
Prompts 
If you do not indicate otherwise, the prompt FSE displays for a 


programmable function key is the same as the directive string you entered 
when redefining the key. If, for example, you defined the shifted F6 key as: 


S K 6 S/ LP;V/ 


the 6 function key prompt is: 


geome QUIT 
You can, however, label the key prompt differently by using the LABEL 
parameter with the SET KEY directive. You could, for example, redefine a 
key to execute two directives, as just described, but only include one function 


on the key prompt. In the preceding example, you could label the key prompt 
LOCPRE, without affecting the two directives it executes, by entering: 


SK S 6/ LP;V/L/LOCPRE/ 


The F'6 prompt is: 


LOCPRE 


Zeus QUIT 


but both the LOCATE PREVIOUS and VIEW directives are executed when 
you press the shifted F6 key. 


NOTE 


Function key labels must be six or fewer characters to fit in the prompt area 
at the bottom of the screen. 


Labeling keys with descriptive phrases rather than the actual directive 
strings themselves helps you better understand each key’s function and 
presents a cleaner looking screen. 


If you want to change the label of a key but leave the directive string 
associated with the key unchanged, include only the LABEL parameter and 
the new label. For example, to change the label of the shifted F6 key from 
LOCPRE to LCTPRV, enter: 


SK S 6 L/LCTPRV 


The shifted F6 key is now labeled LCTPRV while the directive string 
associated with it (LP;V) remains the same. 
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Procedure Branching 


In describing the way to redefine a programmable function key to call a 
procedure (Redefining Programmable Function Keys in this section), we 
created procedure WORD as follows: 


WORD 

SK 1/ .FILL/ 
SK 3/ I W/ 
SK S 3/ D W/ 
SK S 6/ -DEF/ 
S K 8/ .JOIN/ 

S K S 8/.SPLIT/ 
QP 


The shifted F'6 key was redefined to call this procedure (-WORD). Notice that 
procedure WORD again redefines the shifted F6 key, this time to call another 
procedure, procedure DEF. No limits are placed on the number of times you 
can branch off a default setting for a key, creating a procedure that redefines 
a key to call another procedure that redefines a key and so forth. To return to 
the original settings for the keys, create a procedure on FSEPROC that sets 
the function keys to their default. In example procedure WORD, this is the 
function of procedure DEF. 
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@ If the number of procedure branches you create is large, you might find it 
difficult to keep track of which procedure defines the keys in which way. To 
help you remember how your procedures redefine keys, a worksheet is 
provided on the next page. The following example shows how you would use 
the worksheet if you created the sample procedure WORD. 


ORIG (NAL 


TTTITIt 
amc ewue sur sop arr leanel 
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F1 F2 FS F4 F5  F6  F7_ FB8 


F9 F10 F11 F12 F13 F14 #$+j.(F15- £F16 


Fl F2 F3  F4 F5 FG F7_ F8 


F9 F10 + F11 F12 F113 F14 +#=j.(Fl5 F116 


Fl F2 F3  F4 F5 FG F7_ F8 


F9 F10 F171 F112 F113 F14 #415 F16 


Fl F2 F3 F&A FS FE F7_ FB8 


F9 F10 F171 >F12 F113 *F14 F115 ~~ F16 


Changing Your Screen’s Format 


The type of screen format you will want to use depends on the operation you 
intend to perform. If you need to change the format of your screen, use the 
SET VIEW directive and various keyword parameters. With the SET VIEW 
directive you can: 


e Specify the number of lines displayed each time the screen is rewritten. 


e Specify the number of columns to be displayed each time the screen is 
rewritten. 


e Specify the number of lines available for the lower half of a split-screen 
edit. 


e Define the number of columns that can be edited. 
e Change the line length limit. 


e Change the first column displayed at the left edge of the screen. 


Specifying the Number of Lines Displayed 


If you do not want 26 lines (the default value) printed each time the screen is 
rewritten, use the SET VIEW LINE directive. For example, to have only 15 
lines displayed, enter: 


SVL 15 


During subsequent file editing only 15 lines are displayed each time the 
screen is rewritten. These 15 lines include the file header and programmable 
function key prompts. 


Specifying the Number of Columns Displayed 


To specify the number of columns you want displayed each time the screen is 
rewritten, use the SET VIEW COLUMN directive. For example, to print only 
columns | through 60 (the default is 80), enter: 


SV C 60 


Only characters in columns 1 through 60 will be displayed when the screen is 
rewritten. The minimum value allowed is 10. A value exceeding 80 changes 
the screen display to 132-column format (if your terminal has this capability). 
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Specifying the Number of Lines Used for Split- @ 
Screen Editing 


When split-screen editing, you can reduce the number of lines reserved for the 
lower half of the screen. To do so, use the SET VIEW SPLIT directive as | 
shown in the following example. © 


SVS 7 


Subsequent split-screen editing will use only seven lines for the bottom half 
of the screen. 


Specifying Columns That Can Be Edited 


To limit the number of columns that can be edited, use the SET VIEW EDIT 
directive. For example, if you want to edit only the first seven columns of a 
file, enter: 


SVE? 


Subsequent editing will affect only columns 1 through 7. The left margin is 
always column |. 


Changing the Line Length Limit 


To change the line length limit, enter the SET VIEW WARN directive. For 
example, to change the line length to 70 from a previous setting, enter: 


S VW 70 


When a line exceeds 70 characters, FSE will stop directive processing and 
issue a warning message. 


Changing the First Column Displayed 


To view lines that run off the edge of your screen, use the SET VIEW 
OFFSET directive to specify the leftmost column to be displayed. For 
example, to view a line beginning at column 30, enter: 


Ss V0 30 


Column 30 then becomes the leftmost column displayed on your screen. To @ 
return to the default setting (1), enter: 


SV 01 


Column 1 is once more the leftmost column displayed. 
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@ Line Editing 7 


FSE is not exclusively a screen editor; it also functions as a line editor, which 
can be used on any terminal. All but a few of the directives available for 
screen editing are also applicable to line editing. When line editing, enter 
directives after the ?? prompt and then always press: 


More information on the directives is provided in section 4, FSE Directives. 


NOTE 


For each task, examples will show you how an imaginary file would look 
before and after editing. The sample files are not released with the system. 
You must create your own sample files if you want to perform the tasks in 
the examples. 


Getting Started 


@ Setting Line Mode 


To use FSE as a line editor, you must be logged in to NOS. For information 
on NOS login procedures, refer to the NOS 2 Reference Set, Volume 2, Guide 
to System Usage. 


Once logged in to NOS, enter the NOS LINE command. 


LINE 


This sets your terminal in line mode or cancels a SCREEN command if you 
have been screen editing. If you have not been screen editing during your 
current terminal session, you do not need to enter the LINE command; FSE 
is a line editor by default. 
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Starting FSE 


To start FSE, enter the following command, including the name of the file 
you want to edit (MYFILE is the sample file). 


FSE,MYFILE 
The following prompt appears. 
NOS FULL SCREEN EDITOR 


EDIT: MYFILE 
fats 


Creating a File 


To create a file, enter the directive: 
22 INSERT 


to access the insert function (INSERT can be abbreviated to I). Line numbers 
are automatically generated as you enter text and press (NEXT). 


ceca | 
1 ? PROGRAM INDEX 


Each use of (NEXT) advances you one line. Pressing (NEXT) twice returns 


you to the ?? prompt so that you can enter new directives. 


2? PROGRAM INDEX 
cas, 8 
2 
2 


INDEX ALPHABETIZES AND SORTS A FILE CONTAINING A CORRECTLY 


EWN > 


29 


Typing INSERT once again returns you to the line you last called with a 
directive. 
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@ Editing 


Displaying Lines 


& To display all the lines in a file, enter the PRINT ALL directive: 


77° PA 


To display lines 1 through 30 of the file, enter the following PRINT directive: 


72 P1 30 


The first 30 lines of the file are displayed. 


a OE eek a es 
WO CON AU FWN PH OWAN OU FWD 


Mm Po 
- oO 


mm Mm NM Ph 
Om & WW MN 


mm mM 
© 0 ~“ 


30 


MIO a aAOaNM 


PROGRAM INDEX 


INDEX ALPHABETIZES AND SORTS A FILE CONTAINING A CORRECTLY 
FORMATTED MANUAL INDEX. THE PROGRAM RECOGNIZES PRIMARY, 
SECONDARY, AND TERTIARY ENTRIES AS WELL AS THEIR RESPECTIVE 
CONTINUATION LINES. 


IMPLICIT INTEGER (A-Z) 

PARAMETER (PRM=1,PRMC=2,SEC=3,SECC=4, TER=5, TERC=6) 
PARAMETER (MSC=50) 

PARAMETER (MAXILEN=160 ,MAXSLEN=310,MAX%%EN=-60) )).../ 
CHARACTER*40 COND 

CHARACTER*1 CO,CN 

CHARACTER*10 SLANTS 

CHARACTER*12 FMTST 

CHARACTER* (MAXILEN) INPLIN 

CHARACTER*7 PVAL,PNAME 

CHARACTER*7 INPFILE,OUTFILE 

CHARACTER*5O PENTRY, SENTRY, TENTRY ,BLANK 

LOGICAL PARMERR 

DIMENSION TAB(3) 


DATA PENTRY/' '/,SENTRY/* '/,TENTRY/' '/,BLANK/' '/ 
DATA OUTFILE/'OUTPUT'/, INPFILE/ ‘INPUT '/ 

DATA TAB(1)/1/,TAB(2)/5/,TAB(3)/9/ 

DATA FMTCNT/O/,SEPCNT/3/ 

DATA SLANTS/*//////////°/ 


5 ERR=0 


A directive that attempts to display more lines than exist in a file results in 
the message: 


OUT OF BOUNDS 


@ NOTE 


The line numbers are added by FSE so you can see where you are in the file; 
they are not part of the file text. Also, this file, as shown here, contains a few 
errors which will be corrected as we proceed through this section. 
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Searching 


Suppose you want to move the first line in the file containing the string: 
LOGICAL PARMERR 
to the line between present lines 16 and 17. 


To locate the line, you must position the cursor at the first line of the file by 
entering the following PRINT directive. 


2? PI 
The first line is printed. 
1 PROGRAM INDEX 
Then, enter: 
2? L/LOGICAL PARMERR 
The first line containing the string is displayed. 
20 LOGICAL PARMERR 


To see a few lines before and after line 20, enter the following VIEW 
directive. 


veN 


The four preceding lines, line 20, and the four following lines are displayed. 


16 CHARACTER* (MAXILEN) INPLIN 

17 CHARACTER*? PVAL,PNAME 

18 CHARACTER*? INPFILE,OUTFILE 

19 CHARACTER*50 PENTRY,SENTRY, TENTRY ,BLANK 

20 LOGICAL PARMERR 

21 DIMENSION TABC3) 

22 C 

23 DATA PENTRY/' '/,SENTRY/' '/,TENTRY/' ‘/,BLANK/' '/ 
24 DATA OUTFILE/ ‘OUTPUT'/,INPFILE/ ‘INPUT '/ 
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é Inserting Lines 


To insert: 
LOGICAL PARMERR 

between lines 16 and 17, enter the following INSERT directive. 
2? 116 

FSE prompts you with: 
17 ? 

You then enter the line to be inserted. 


17 ?\LOGICAL PARMERR 
18 ? 


The \ 1s the default tab character. Because the default tabs are set at 7 and 
72, LOGICAL starts at column 7. 


You can enter as many lines as you want on any insertion, ending the 
insertion either by entering a tab character at the end of an inserted line or 
by pressing: 


on an empty line. 


You then display the surrounding lines with the VIEW directive. 


27, 

13 CHARACTER*1 CO,CN 

14 CHARACTER*10 SLANTS 

15 CHARACTER*12 FMTST 

16 CHARACTER*(MAXILEN) INPLIN 

17 LOGICAL PARMERR 

18 CHARACTER*7 PVAL,PNAME 

19 CHARACTER*7 INPFILE,OUTFILE 

20 CHARACTER*50. PENTRY SENTRY, TENTRY ,BLANK 
21 LOGICAL PARMERR 


Notice that the line numbers following 17 have all increased by one to 
accommodate the new line. 


NOTE 


To insert characters while line editing, use the ALTER directive, described in 
section 4. 
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Deleting Lines 


To delete LOGICAL PARMERER on line 21, enter: 
2? D21 

The deleted line is displayed at your terminal. 
21 LOGICAL PARMERR 


You can delete more than one line at a time. To delete lines 25 through 27, for 
example, enter the following DELETE directive. 


2? D25 27 


The deleted lines are displayed, and line numbers on the remaining text shift 
accordingly. 


25 DATA TAB(1)/1/,TAB(2)/5/,TAB(3)/9/ 
26 DATA FMTCNT/O/,SEPCNT/3/ 
27 DATA SLANTS/'//////////'/ 


To avoid the display of these lines, include the QUIET parameter. 
D 25 27 Q 


(If you decide that you want these lines returned, use the UNDO directive.) 


Getting Online Help 


Suppose you then need to change line 11, but cannot quite recall how the 
ALTER directive works. To get help, enter the following directive. 


2? H ALTER 


This directive accesses the FSE HELP file and positions the cursor at the 
area of text describing the ALTER directive. To continue reading the HELP 
file text, enter PRINT directives as needed. For example, to read the next 20 
lines, enter PN20. When you have read the needed information, the following 
directive returns you to file MYFILE. 


?? BACK 


NOTE 


To delete characters while line editing, use the ALTER directive, described in 
section 4. 
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Changing Lines 


You then enter the following PRINT directive to position the cursor to line 
11. 


2? P11 
The line is displayed. 

11 PARAMETER (MAXILEN=160 ,MAXSLEN=310,MAX%ZEN=-60) )).../ 
You enter the following ALTER directive. 

2? A 
FSE responds with the following prompt. 


11 PARAMETER (MAXILEN=160 ,MAXSLEN=310,MAX%%ZEN=-60) )) .../ 


Ace 


You then space over to where the change is to be made and enter the 
correction underneath the error. 


11 PARAMETER (MAXILEN=160,MAXSLEN=310,MAX%%EN=-60) )) .../ 
A?? Ol 1 |! 


e The entries in this example perform the following functions. 


Entry Function 


Space No effect on the line. 


8) Replaces first '%. 
L Replaces second '%. 
1 Replaces -. 


! Truncates the line at the current character. 


When you press (NEXT), the corrected line is displayed. 


11 PARAMETER (MAXILEN=160 ,MAXSLEN=310 ,MAXOLEN=160) 
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Copving Lines 


To copy lines 8 through 12 immediately after line 15, enter the following 
COPY directive: 


2? € 8 12 TO 15 


The copied lines and their new line numbers are then displayed. 


16 IMPLICIT INTEGER (A-Z) 

17 PARAMETER (PRM=1 ,PRMC=2,SEC=3,SECC=4,TER=5 , TERC=6) 
18 PARAMETER (MSC=50) 

19 PARAMETER (MAXILEN=160 ,MAXSLEN=310,MAXOLEN=160) 

20 CHARACTER*40 COND 


Replacing Text 


To replace all occurrences of INTEGER with INT, enter the following 
REPLACE directive. 


22? RA/INTEGER/ INT 
The lines affected by the change are displayed. 


8 IMPLICIT INT (A-Z) 
71 INTCA1) 
90 INT(B23) 


After the replacement is completed, the cursor is positioned at the last line 
affected. In this example, the cursor would rest at line 90. 


Undoing Changes 


If you need to undo a change to your file, enter the UNDO directive. For 
example, to undo the last REPLACE directive, enter: 


2? UNDO 


All the INTEGERs that were replaced with INT are now changed back to 
INTEGER. To undo other changes made to your file during your current 
editing session, enter an UNDO directive for each item you want restored. 
The changes are undone in the reverse order of their occurrence. UNDO will 
not display the reinstated line; however, you can enter the PRINT directive 
to verify that the changes have been undone. 
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& Stopping FSE and Returning to NOS 
To stop FSE and return to NOS, enter: 
?? QUIT 
& The following message then appears. 
FILE: MYFILE 


This message tells you that you have made changes to file MYFILE but they 
are not permanent. 


Restarting FSE 


To return to FSE at the point you left, enter the FSE command without 
parameters. 


FSE 


In this example, you are positioned at line 90, the point at which you stopped 
FSE with the QUIT directive. 


Stopping FSE and Making Your Changes 
& Permanent 


To stop FSE and make the changes to your file permanent, enter the 
following QUIT REPLACE directive. 


QR 


The following message appears, confirming that the changes have been 
made permanent. 


FILE: MYFILE (PERMANENT) 


Editing Sequenced Files 


When editing or creating files in the BASIC or FORTRAN subsystem, FSE 

assumes the file is a numbered sequenced file. In directives, you can then 

refer to the sequence numbers rather than to the internal line numbers FSE 

provides. Refer to the SET NUMBER directive for more information on 
_ manipulating sequence numbers. 
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Using Other Terminals | 8 


®@ Using Other Terminals ) 


This section provides you with worksheets to record the keys on your 

terminal that correspond to the Viking 721 terminal keys and the default 

settings of programmable function keys F1 through F16. For example, the 
 ] (NEXT) key description appears on the worksheet as: 


Viking 
721 Key Your Terminal Key Function 
Terminates the input line. 


If you were using the worksheet on a CDC 722 terminal, you would fill in the 
space provided as follows: 


Viking 
721 Key Your Terminal Key Function 


NEW LINE on CR Terminates the input line. 


Space is also provided for any information not covered in the worksheet that 
you want to include. 


Refer to appendix D for information on corresponding keys for the CDC 722, 
DEC VT100, Zenith Z19, Heathkit H19, Lear Siegler ADM38A and ADMS5, 
@ and Tektronix 4115 terminals. 
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Terminal 


~ Viking 
721 Key Your Terminal Key Function 
—____S™C*—<“‘« Ad aaances: Screen ne pace j. 
Oca —__——<—é—‘“«~w Movies celern back waar O|ee page. 
—____—™—<“<i‘“—«‘«~w Mtoe‘ the current line to thee tp ff thee 


screen. 


+ Moves the current line to the bottom 


of the screen. 


__CC*S splays the FSE HELP file. 

—__—t*~—<“‘;é‘«éRReettrrns yo to’ thee previously edited 
file. 

(<s) —_C~—‘s‘éCin ert a lank line, allowing you to 
type in a new line of text. 

—_C—C——C—~—CSUeerts aa blank character into which 
you type a new character. 

(dS) —C~*~é‘é«éCZS éilettle's: thee crrrrenntt inne. 

© Deletes the current character. 
(<) —___—é—“‘“‘#@RRe@wrr'ite's: the entire Screln.. 
—___C~*~é@Pc-Siitti’onS the currScOr at the FSE 


directive line, allowing you to enter 
FSE directives. 


NEXT a —<“<«é‘sr ermine’ an innutt nce. 


oe" Programmable Function Key Settings 
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& Terminal... 


Viking 
721 Key Your Terminal Key Function 


 ] —— Advances screen one page. 


Moves screen backward one page. 


ae ee rete Moves the current line to the top of the 
screen. 

re Eee ae Moves the current line to the bottom 
of the screen. 

_________—S_— Displays the FSE HELP file. 

eee ee ee Returns you to the previous edit file. 


(Sd) re ae eT a Inserts a blank line, allowing you to 


type in a new line of text. 


ee Inserts a blank character into which 
you type a new character. 


(<a) eee see ee Deletes the current line. 


eee ee eee eee Deletes the current character. 
(S) ee ee Rewrites the entire screen. 
eee Positions the cursor at the FSE 


directive line, allowing you to enter 
FSE directives. 


NEXT EO A eee ee Terminates an input line. 


e Default Programmable Function Key Settings 
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Code Set Conversion A 


The code conversion information in this appendix is provided to help you 
interpret information coded in 6/12-bit display code or 7-bitt ASCII code 
when it is displayed in 6-bit display code form. The left side of table A-1 lists 
the 128-character ASCII character set with the corresponding 6-bit display 
code values. The right side of the table shows the 6/12-bit display code and 
7-bit ASCII code characters as they appear when displayed in 6-bit display 
code format. 


Table A-1. Code Conversion Chart 


6-Bit 6/12-Bit 
Display Display 7-Bit 
ASCII (128-Character) Code Code ASCII 
——— pe a ee Te 6d 
Character Octal Hex. Char. Octal Char. Octal Char. 
NUL 000 00 5 7640 D: 
SOH 001 Ol “6 7641 ‘A 
STX 002 O2 re 7642 -B 
ETX 003 03 “8 7643 :C 
EOT 004 04 “9 7644 -D 
ENQ 005 05 i 7645 al 
ACK 006 06 a 7646 -F 
e BEL 007 07 vt 7647 ‘G 
BS O10 O08 / 7650 :H 
HT O11 O9 ( 7651 al 
LF O12 OA *) 7652 id 
VT O13 OB “$ 7653 7K 
FF O14 OC = 7654 :L 
CR O15 OD “sp 7655 :M 
SO O16 OE ea 7656 :N 
SI 017 OF “ 7657 :O 
DLE 020 10 “# 7660 P 
DCI 021 11 Al 7661 :Q 
DC2 (22 12 a 7662 -R 
DC3 023 3 “% 7663 SS 
DC4 (24 14 = 7664 Ak 
NAK O25 15 an 7665 :U 
SYN 026 16 “t 7666 :V 
ETB 027 17 “& 7667 :W 


_ Continued on next page 


1 7-bit ASCII characters occupy the rightmost 7 bits of a 12-bit field. The 
@ leftmost 5 bits are unused. 
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Table A-1. Code Conversion Chart (Continued) 


6-Bit 6/12-Bit 
Display Display 7-Bit 
ASCII (128-Character) Code Code ASCII 
So 6. Code 
Character Octal Hex. Char. Octal Char. Octal Char. © 
CAN 030 18 me 7670 X 
EM 031 19 ae 7671 ay: 
SUB 032 1A nd 7672 :Z 
ESC 033 1B = 7673 :0 
FS 034 1C *@ 7674 1 
GS 035 1D os 7675 :2 
RS 036 1E ee 7676 :3 
US 037 1F me 7677 4 
sp 040 20 sp a8) sp a3) 5 
! Exclamation Point 041 21 ! 66 ! 66 6 
* Quotation Marks 042 22 “ 64 . 64 EL 
# Number Sign 043 23 # 60 # 60 8 
$ Dollar Sign 044 24 $ 53 $ 5S 9 
% Percent Sign 045 25 % 63 % 63 r+ 
& Ampersand 046 26 & 67 & 67 : 
’ Apostrophe 047 27 , 70 ; 70 cl 
(Opening Parenthesis 050 28 ( 51 ( dl 7: 
) Closing Parenthesis 051 29 ) 52 ) 52 “( 
* Asterisk 052 2A * 47 . 47 :) 
+ Plus 053 2B + 45 + 45 :$ 
, Comma 054 2 : 56 ; 56 
- Dash 055 2D - 46 - 46 ‘sp 
. Period 056 2E , 57 : a E 
/ Slant 057 2F / 50 e 50 7 
0 060 30 0 33 0 33 # 
1 061 31.1 34 1 34 | 
2 062 32 2 35 2 35 :| 
3 063 33 3 36 3 36 % 
4 064 34 4 37 4 37 
5 065 35 5 40 5 40 om 
6 066 36 6 41 6 4] 7 
7 067 37 7 42 7 42 :& 
8 070 38 8 43 8 43 ra 
9 O71 39 9 44 9 44 4 
: Colon 072 3A 00 @D 7404 < 
; Semicolon 073 3B : 77 : 77 = 
< Less than 074 «#23C—CO< 72 < 72 -@ & 
= Equals 075 3D = 54 = 54 \ 
> Greater than 076 3E = 73 > 73 : 
? Question Mark 077 3F ? 71 ? 71 : 


Continued on next page 
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Table A-1. Code Conversion Chart (Continued) 


6-Bit 6/12-Bit 
Display Display 7-Bit 
ASCII (128-Character) Code Code ASCII 
ee ee OA 
Character Octal Hex. Char. Octal Char. Octal Char. 
@ Commercial At 100 40 @ 74 @A 7401 A: 
A 101 4] A 0] A Ol AA 
B 102 42 B 02 B 02 AB 
C 108 43 C 03 c 03 AC 
D 104 44 9) O4 1) 04 AD 
E 105 45 E O5 E O5 AE 
Fk 106 46 F 06 F 06 AF 
G 107 47 G O7 G O7 AG 
H 110 48 H 10 H 10 AH 
I 111 49 ] 1] I 14 Al 
J E12 4A J 12 J 12 AJ 
K hs 4B K 13 K 13 AK 
L 114 4C is 14 L 14 AL 
M 115 41) M 15 M 15 AM 
N 116 4 N 16 N 16 AN 
O 117 4k O 17 O 17 AO 
P 120 0) Pp 20 P 20 AP 
®) 121 51 Q 2) Q 2 AQ 
R 122 52 R oe R 22 AR 
S (Nees O83 S 23 S 20 AS 
r 124 4 T 24 T 24 AT 
U 125 a0 U 29 U 20 AU 
V 126 D6 V 26 V 26 AV 
W ea ot W Zi W 21 AW 
xX 130 8 X 30 XxX 30 AX 
Y 131 a9 Y 3] Y 3] AY 
ZL 132 DA 7, a2 Z, 32 AZ 
[ Opening Bracket 133 5B [ 61 [ 61 AO 
\ Reverse Slant 134 aC \ 75 \ 75 Al 
] Closing Bracket 135 aD ] 62 ] 62 A2 
° Circumflex 136 dE 76 (aB 7402 A3 
_ Underline oa oF ie 65 = 65 A4 
’ Grave Accent 140 60 @ 74 @G 7407 A5 
a 141 61 “A 7601 A6 
b 142 62 °B 7602 A7 
c 143 63 ie 7603 A8& 
d 144 64 “DD 7604 A9 
e 145 65 °K 7605 At 
f 146 66 °F 7606 A- 
g 147 67 °G 7607 A* 


Continued on next page 
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Table A-1. Code Conversion Chart (Continued) 


6-Bit 6/12-Bit 
Display Display 7-Bit 
ASCII (128-Character) Code Code ASCII 

oe ek ee a Oe 
Character Octal Hex. Char. Octal Char. Octal Char. 
h 150 68 °H 7610 A/ 
1 151 69 a | 7611 A( 
j 152 6A “J 7612 A) 
k 153 6B “K 7613 A$ 
] 154 6C as 7614 = 
m 155 6D °M 7615 Asp 
n 156 6E “N 7616 A, 
) 157 6F °O 7617 A. 
p 160 70 a cd 7620 A# 
q 161 71 °Q 7621 A[ 
r 162 He “R 7622 A] 
s 163 13 “Ss 7623 AN% 
t 164 74 a 7624 A” 
u 165 75 a 7625 AL 
Vv 166 76 =: 7626 A! 
w 167 77 ~W 7627 A& 
Xx 170 78 “X 7630 A’ 
y 171 79 “¥ 7631 A? 
Z L72 7A “Z, 7632 A< 
{ Opening Brace 173 7B [ 61 “0 7633 A> 
| Vertical Line 174 7C \ 75 “I 7634 A@ 
| Closing Brace 175 7D ] 62 oes 7635 A\ 
~ Tilde 176 7E . 76 “3 7636 A* 
DEL 177 7F “4 7637 A; 


NOTE: sp represents a space. 
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® Error Kecovery and 
Diagnostic Messages B 


Appendix B contains procedures for recovering from errors that either cause 

© you to lose the connection to NOS or, when screen editing, cause your screen 

~ to become garbled. This appendix also contains alphabetical listings of FSE 
diagnostic messages. 


Error Kecovery 


This subsection describes how to recover your FSE session if one of the 
following errors occurs. 


e The screen is garbled due to communication errors. 


e The connection to NOS is lost. 


Recovering from Communication Errors 


If communication errors cause your screen to become garbled, you can 
¢ rewrite the current screen as follows: 


e If you are on a Viking 721 terminal, press: 


() GLEAA) + (NEXT) 


e If you are ona CDC 722 terminal, press: 


(EOP) + (NEWLINE) 


® On any terminal, press: 


(or the equivalent key) to position the cursor on the FSE directive line. 
Then enter: 


S$ 
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Recovering When You Lose the NOS Connection 


The following procedure restores your FSE session should you lose the 
connection to NOS. 


1. Log in to NOS. 


WELCOME TO THE NOS SOFTWARE SYSTEM. 
COPYRIGHT CONTROL DATA 1978, 198x. 


yy/mm/dd 13.20.42 L3FT1 

CDC NETWORK OPERATING SYSTEM NOS 2 
FAMILY: fami lyname ,username ,password 
JSN: ABVU, NAMIAF 


2. When the following appears, enter the job sequence name (JSN) of the job 
to recover. In this example, only job ABVJ can be recovered. 


RECOVERABLE JOB(S) 

JSN UJN STATUS TIMEOUT 

ABVJ  AKVA SUSPENDED 29 MIN. 
ENTER GO TO CONTINUE CURRENT JOB, 


RELIST TO LIST RECOVERABLE JOBS, 
OR DESIRED JSN: abv} 


3. Do not enter GO when the following message appears. 


JSN: ABVJ SYSTEM: BATCH SRU: 2.679 
STATUS: FSE,MYFILE,A,G. 

CHARACTER SET: ASCII MODES: PROMPT ON 
INPUT REQUESTED. ENTER GO TO CONTINUE. 


Instead, press: 


The following FSE prompt appears. 
2 
4. Respond to the prompt with: 
S°S 
This returns you to where you left off in your FSE session. 


Refer to the NOS Reference Set, Volume 2, Guide to System Usage, for © 
detailed information on NOS login and job recovery procedures. 
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Diagnostic Messages 


FSE diagnostic messages are grouped in two categories: user messages and 
internal messages. User messages appear when you make a mistake while 
using FSE. Internal messages appear because FSE made a mistake; they are 
always preceded by a line that says FSE INTERNAL ERROR and followed by 
CONTACT SOFTWARE SUPPORT. 


The user messages are listed here followed by the internal messages. If you 
receive a message not listed, either refer to the NOS Reference Set, Volume 3, 
System Commands, or contact Central Software Support. 


User Messages 
BATCH JOBS MUST BE ERROR FREE. 


A syntax error occurred on a noninteractive FSE session. Correct the job 
and try again. 


CANNOT CHANGE READ-ONLY FILE. 

You tried to change a file that you are not allowed to change. 
CHARACTER SEQUENCE NOT RECOGNIZED. 

Your input is not recognized by FSE. Check the spelling and try again. 


DIRECTIVE CANCELLED BY FUNCTION KEY. 


@ You pressed a function key before a directive had finished executing. The 
function key cancels the directive and executes the function. No action on 
your part 1s required. 


EMPTY FILE. 


You have specified a file that contains no lines. Try again with the correct 
file name. 


END OF LINE BEYOND EDGE OF SCREEN. 
You tried to position the cursor to the end of a line that. extends beyond 


the edge of the screen. Use the appropriate key or directive to view the 
wide line. 
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ERROR IN THIS PROCEDURE LINE. 


The procedure line displayed contains an error. Correct the error and try 
again. 


FILE MUST BE ON DISK. 


The file you specified is not on a mass storage device and could not, 
therefore, be located. Try again with a valid file name. 


FILE MUST NOT CONTAIN SEQUENCE NUMBERS. 


The directive you specified can be performed only on files without 
sequence numbers. Try another directive or file. 


FILE NAME IN USE. 


The file name you specified is already in use in the work file. Select a 
different file name and try again. 


INTERNAL ERROR..... 
Refer to the following Internal Messages subsection. 
INVALID FILE NAME. 


You specified an invalid file name. Check the spelling of the file name and 


try again. _ 


KEYWORD MUST FOLLOW SET. 


You entered an invalid keyword parameter following the SET directive. 
Check the syntax of the SET directive and try again. 


LINE INCREMENT VALUE TOO LARGE. 


The value you specified on the SET INCREMENT directive is too large 
for the specified file. Try again with a smaller increment. 


MARKS CANCELLED. 


You cancelled the previously set marks by either pressing UNDO or 
entering the UNDO directive. 


MISSING REPLACEMENT STRING. 


You entered a REPLACE directive that did not contain a replacement 
string. Try again with a specified string. @& 


B-4 FSE User’s Guide Revision A 


MUST SPECIFY FILE NAME. 


The FSE directive you entered did not contain a valid file name. Try 
again with a valid file name. 


MUST SPECIFY YES OR NO. 


You specified a keyword parameter other than YES or NO. Try again 
with YES or NO specified. 


NOT ENOUGH ROOM FOR INSERTION. 


There is not enough room for you to insert any lines. Resequence the line 
numbers and try again. 


NOT FOUND. 


The string you specified on a LOCATE or REPLACE directive was not 
found in the file. Check the spelling of the string and try again. 


ONLY ONE RANGE ALLOWED. 


You specified more than one range. Check the syntax of the desired 
directive and try again. 


OUT OF BOUNDS. 


The range you specified is out of bounds. Specify a smaller range and try 
again. 


PARAMETER NOT VALID FOR THIS DIRECTIVE. 


You have specified a keyword parameter that FSE does not recognize. 
Check the command syntax and try again. 


PFN BUSY OR NOT FOUND, USING LOCAL FILE. 


FSE could not access the permanent file specified on the FSE command 
because it was busy or the file does not exist. FSE then uses the local copy 
of the file, if any. Check the file name and try again. 


PLEASE RE-ENTER INPUT. 


You must wait until one directive or function has completed before you 
can enter another. Try again. 


PROCEDURE NOT FOUND. 


FSE could not find the procedure specified. Check the file on which the 
procedure resides, check the spelling, and try again. 
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QUIT IS REQUIRED FOR BATCH JOBS. 


You did not include a QUIT directive in a noninteractive FSE session. 
Add a QUIT directive and try again. 


RANGE MUST BE IN SAME FILE. 


The range you specified spanned more than one file. Try again with the 
range limited to one file. 


RESERVED FILE. 


You tried to edit a file that is protected from editing. Start FSE again with 
a valid file name. 


RETURN MUST FOLLOW FUNCTION KEY. 


You must enter a carriage return after pressing the specified function key. 


Try again, pressing after the function key. 
SCREEN MODE REQUIRED. 


You tried an editing function that works only in screen editing mode. 
Either try another function or set screen mode and try again. 


SET UNDO YES - TO ENABLE UNDO. 


You tried to enter the UNDO directive while it is not enabled. Enable 
UNDO (using the SET UNDO YES directive) and try again. 


STRING GREATER THAN 80 CHARACTERS. 


You entered a string containing a line longer than the allowable limit (80 
characters). 


STRING NOT ALLOWED. 
You entered a string when none is required. Try again without the string. 
SYSTEM INTERRUPT, PROCEED NOW. 


A forced transaction from multiuser FSE to single-user FSE has occurred. 
This is not a result of anything you did. Resume editing. The effects of the 
previous directive may be cancelled. 


TAB FIELD ORDINAL OUT OF BOUNDS. 


You specified a tab field that was out of range. Try again with a valid tab 
field. 
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TAB STOP OUT OF BOUNDS. 


You specified a tab field that is out of range. Try again with a valid tab 
field entry. 


TERMINAL MODEL NAME UNKNOWN. 


You entered an incorrect terminal model name. Check the terminal model 
and try again. 


TOO MANY PARAMETERS. 


You specified too many parameters on one directive. Take off a few 
parameters and try again. 


UNKNOWN CONTROL KEY. 
FSE detected a bad code sequence you entered. Try again. 
UNKNOWN DIRECTIVE. 


You entered a directive that FSE did not recognize. Check the spelling 
and syntax and try again. 


UNKNOWN FSE COMMAND OPTION. 


You specified an option on the FSE command that FSE did not recognize. 
Check the FSE command format and try again. 


UNSUPPORTED FUNCTION KEY. 


FSE does not support the key you pressed. Check the key you want and 
try again. 


VALUE MUST BE NUMERIC. 


You entered a nonnumeric value for a keyword parameter that must be 
numeric. Enter a numeric value and try again. 


WIDE LINE. 


You specified a range of lines containing a line longer than the limit. To 
complete the processing of the line range, increase the line width limit. 
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Internal Messages 


The following messages are always preceded by the line 
FSE INTERNAL ERROR. 


NOTE 


When an FSE internal error message occurs, you should attempt to repeat 
the procedure that produced the message. If the message reappears, contact 
Central Software Support. 


ALL WORKFILE BUFFERS ARE FULL. 
FSE encountered a full working buffer while trying to store data. 
ALTERED PRU WAS NOT REWRITTEN. 


FSE failed to rewrite an altered PRU before reusing the buffer. Contact 
Central Software Support. 


BAK BEFORE START OF FILE. 


FSE attempted to access a line located before the first line of the file. 
Contact Central Software Support. 


DIRECTORY BLOCK POINTER TOO LARGE. 


The directory block pointer is greater than the value allowed. Contact ® 
Central Software Support. 


DIRECTORY BLOCK POINTER TOO SMALL. 


The directory block pointer is less than the value allowed. Contact Central 
Software Support. 


FILE MUST BE ON DISK. 


The file specified on the FSE command is not on a mass storage device. 
Try again with a valid file name. 


FILE POSITION STACK OVERFLOWED. 


The stack that monitors the file position overflowed. Contact Central 
Software Support. 


FILE POSITION STACK UNDERFLOWED. 


The stack that monitors the file position underflowed. Contact Central @ 
Software Support. 
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FILE SIZE INCORRECT. 


The file size (EOI sector) reported by CIO conflicts with FSE. Contact 
Central Software Support. 


FILE TOO LARGE. 


The file you are attempting to edit is too large for FSE to handle. Contact 
Central Software Support. 


FWD BEYOND END OF FILE. 


FSE attempted to access a line located after the last line of the file. 
Contact Central Software Support. 


LINE NOT FOUND IN FILE. 


FSE attempted to access a line that does not exist in the file. Contact 
Central Software Support. 


NO FILE NAME ON FSE COMMAND. 


You entered an FSE command without specifying a file name. Reenter the 
FSE command with a valid file name. 


OLD SECTOR MUST BE WRITTEN. 


FSE attempted to allocate a new sector without first flushing the old 
sector to disk. Contact Central Software Support. 


OUT-OF-BOUNDS PRU ADDRESS ON READ. 


FSE attempted to read a sector address that is out of bounds. Contact 
Central Software Support. 


PREVIOUS VERSION OF WORKFILE. 


FSE and the workfile versions do not match. Contact Central Software 
Support. 


PRU CONTENT INCORRECT. 


The content of the PRU read does not match the expected value. Contact 
Central Software Support. 


RANDOM ADDRESS INCORRECT. 


The random address returned by CIO after a random rewrite conflicts 
with FSE. Contact Central Software Support. 
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RANDOM READ LIST INCORRECT. 


The read list did not contain the sector FSE was trying to access. Contact 
Central Software Support. 


REENTRANT DATA STACK OVERFLOWED. 


The general purpose data stack for re-entrant code overflowed. Contact 
Central Software Support. 


REENTRANT DATA STACK UNDERFLOWED. 
The general purpose data stack for re-entrant code underflowed. 
RPHRLS LIST BUFFER IS FULL. 


The list buffer for the RPHRLS macro is full. Contact Central Software 
Support. 


SECTOR CANNOT BE DEALLOCATED. 


FSE attempted to deallocate a block that was still valid. Contact Central 
Software Support. 


STATUS FLAGS SHOULD HAVE BEEN CLEARED. 


The content of the PRU read includes status flags that should have been 
cleared previously. Contact Central Software Support. 


TRANSFER TO THE BUFFER IS INCOMPLETE. 


The buffer transfer on a COPY or MOVE is incomplete. Contact Central 
Software Support. 


UNABLE TO WRITE FROM BUFFER. 


FSE was unable to write and empty the circular buffer. Contact Central 
Software Support. 


UNKNOWN TERMINAL MODEL NUMBER. 
The terminal model number specified is not defined. 
WORKFILE BUFFER ALLOCATED TWICE. 


FSE encountered a sector written in two different areas of the work file. 
Contact Central Software Support. 


WORKFILE BUFFER CONTAINS WRONG TEXT. 


FSE encountered a working buffer with incorrect text. Inform Central 
Software Support. 
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WORKFILE BUFFER EMPTY ON READ. 


FSE encountered an empty circular buffer while reading the workfile. 
Contact Central Software Support. 


WORKFILE BUFFER FULL ON READ. 


FSE encountered a full circular buffer while reading the workfile. Contact 
Central Software Support. 


WORKFILE BUFFER FULL ON WRITE. 


FSE encountered a full circular buffer while writing the workfile. Contact 
Central Software Support. 


WORKFILE IS NOT IN A RESUMABLE STATE. 


FSE could not recognize the contents of the workfile. Contact Central 
Software Support. 
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Glossary C 


A 
ASCII 


American National Standard Code for Information Interchange. A 7-bit 
code representing a prescribed set of 128 characters including both 
uppercase and lowercase letters. 

ASCII Mode 


Use of the American National Standard Code for Information 
Interchange 128-character set. It includes both uppercase and lowercase 
letters. 


Attach 


The process of retrieving a direct access permanent file to use at your 
terminal by specifying the proper permanent file identification and, if 
required, passwords. 


B 
BACK 


The FSE directive that returns you to a previously edited file, or allows 
you to exit the HELP file. 
BASIC 


1. Beginner’s All-Purpose Symbolic Instruction Code, an elementary 
programming language. 


2. The subsystem that uses the BASIC compiler. 
Batch Job 


Instructions and data submitted as a complete unit without further 
intervention on your part. 


Batch Mode 


Mode in which instructions and data are submitted as complete units 
without further intervention on your part. 


Break 


An interruption in the data stream. A user break (a break normally 
entered by you at your interactive terminal) stops delivery of a message or 
output from the host. 
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C 
CDC Standard Keys 


Keys that perform functions on nearly all applications and can be 
performed on all supported terminals. 


Character 


Any alphabetic, numeric, or special symbol that can be encoded. This 
term applies to the graphic characters for an input or output device, and 
to uniquely encoded control characters used by a terminal. 


Character Set 


A prescribed set of characters, specified at the time the operating system 
is Installed. FSE supports the 128-character ASCII character set and also 
subsets such as the CDC 64-bit character set. 


Command 


An instruction you give to NOS that causes it to perform an operation. 


Current Character 


The character on which the cursor is positioned. 


Current Editing Session 


The editing session started with the latest entry of the FSE command that 
included parameters. 


Current Line 


The line on which the cursor is positioned. 


Current Screen 


The text appearing on your screen. 


Current Terminal Session 


The terminal session started with the latest physical connection to the 
system. 
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@>- 
Default 


A system-supplied value used when you do not supply a value. 


@ Direct Access File 
A NOS permanent mass storage file that can be attached to your terminal 
session. All changes to this file are made on the file itself, rather than on 
a temporary copy of the file (compare with Indirect Access File). 


Directive 


An instruction to FSE. 


Display Code 


A 6-bit character code set used to represent alphanumeric and special 
characters. Display code includes only uppercase letters. 
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E 


Editing Keys 
Keys, such as , (ERASE), and others, whose functions 


are predetermined and usually performed by software at your terminal. 
Contrast with Programmable Function Keys. 


Editing Session 


The time elapsing from when you start FSE (by entering the FSE 
command with parameters) to when you stop FSE (by either logging off 
NOS or entering another FSE command with parameters). You can 
restart your previous editing session by entering the FSE command 
without parameters. 


Ellipsis String 
A parameter delimited by strings enabling you to specify longer strings. 


The first string delimiter must be on the same line as the last string 
delimiter. 


EOF (End-of-File) 


A boundary within a sequential file. EOF is not necessarily the end of a 
file that can be referenced by name. The actual end of a named file is 
defined by EOI. In the product set manuals (FORTRAN and so forth), an 
end-of-file is also referred to as an end-of-partition. 


EOI (End-of-Information) & 


The end of data on a file. Information appearing after this point is not 
considered file data. CDC CYBER Record Manager defines end-of- 
information in terms of file residency and organization. 


EOR (End-of-Record) 


An indicator that marks the end of a logical record. In product set 
manuals (FORTRAN, and so on), end-of-record is also referred to as 
end-of-section. 


C-4 FSE User’s Guide Revision A 


F 

File 
A collection of information referred to by a file name (seven or fewer 
alphanumeric characters). You can create a file at your terminal or 


retrieve a file from permanent file storage for use during a terminal 
session. 


File Header 


In FSE screen mode, the file header is the line containing the following 
information. 


e File name and type. 
e Range of lines currently displayed. 


e Total number of lines in the file. 


File Name 
Name assigned to a file; it can contain from one through seven letters and 
digits, the first of which must be alphabetic. 

FORTRAN 


1. Formula Translation, a high-level language consisting of symbols and 
statements that can be used to create a program closely resembling 
mathematical notation. 


2. The subsystem that uses the FORTRAN Version 5 compiler. 


FSE 
The NOS command that starts the Full Screen Editor. 


FSE Procedures 


Groups of directives that perform the FSE functions and can be grouped 
under one name. 


FSEPROC 
The library file in which most FSE procedures reside. 


Full Screen Editor 


An editing utility that enables you to edit files either screen-by-screen or 
line-by-line. 
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H 
HELP File 


An online reference aid that lists the FSE directives and their parameters. 


Indirect Access File 


A NOS permanent file that you access by making a temporary copy of it 
(GET or OLD command). You create or alter it by saving or substituting 
the contents of an existing temporary file (QUIT REPLACE directive). 


Input 


Information flowing from your terminal to the host mainframe. 


K 


Keyword 


A type of parameter used in an FSE directive, usually followed by a value. 


L 


Line Mode 
The FSE editing mode in which a line of the file is the basic unit of 
operation. 

Local File 
Any file assigned to your terminal session; this includes all temporary 
(indirect access permanent) files, all direct access permanent files, and all 
files that are not permanent. 

Login 


The procedure used at an interactive terminal to gain access to the 
system. 


Logoff 


The procedure used to end a terminal session. 
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= 


Micros 


Commands within procedures or directive strings that allow you to 
specify the current character, word, line, or file as a parameter. 


& Modification Character 


A special character (#, &, !, or ~ characters) used with the ALTER directive 
to change text. 


N 


NOS 
Network Operating System. 


O 


Output 


Information flowing from the host mainframe to your terminal. 
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P 
Pad Shifted 


Terminal characteristic that enables shifted keypad functions. 


Paragraph 


A group of lines not containing a blank line. 


Parameter 


A value following a command name or directive name that alters the 
behavior of the command or directive. 


Permanent File 


A file that does not disappear when you log off the system. There are two 
types of permanent files on NOS: indirect access and direct access. 


You access indirect access permanent files indirectly (hence, the name). 
That is, NOS makes a copy of your permanent file, which you can then 
use without affecting the permanent copy. 


Direct access files are accessed directly and any changes you make are 
made to the actual permanent file. 


Usually, indirect access files are used for smaller files and direct access 
files are used for very large files. 


Procedure 


A user-defined set of instructions that are referenced by name. Within 
FSE you can use procedures that consist of FSE directives. 


Programmable Function Keys 
Keys defined either by FSE or by you to perform FSE functions. 
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Q 
6 an 


The FSE directive used to exit the editor, exit the TEACH file, or end a 
procedure. 


@. 


Record 


Divisions within a file. Within FSE, the FSEPROC file contains 
procedures. Each of these procedures is a record terminated by an (EOR) 
marker or a QP directive. 


Restart 


Re-entering FSE at the point you exited. To restart FSE, enter the FSE 
command without parameters. 


S 


Screen Mode 


The FSE editing mode in which a file is edited with a page of text as the 
basic unit of operation. 


Soft Tab Character 
© A software character instructing FSE to move text to the next tab setting. 


String 


Any combination of alphanumeric characters bounded by delimiters. 
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T 


TEACH File 


A tutorial designed to help the user become familiar with the Viking 721 
terminal and the basics of screen editing. 


Temporary File 


A file that is assigned to your terminal session and vanishes when you 
either release it or end your terminal session. Local copies of indirect 
access permanent files are temporary files; direct access permanent files 
assigned to your terminal session are not temporary files. 


Terminal Definition Utility (TDU) 


The utility that allows you to define your terminal’s characteristics to 
NOS. 


Terminal Session 


The lapse between the time you physically connect the terminal to the 
system and the time you log out. 


Typematic 


A terminal characteristic that causes keys to automatically repeat their 
functions when held down. 


U 


UNDO 


An editing directive that allows you to delete changes you have made in 
the reverse order that they were made. UNDO should be turned off for 
batch processing (SET UNDO NO). 


W 
Word 


A string of text delimited by nonalphanumeric characters or blank 
characters. 
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& Terminal Support Information D 


This appendix provides you with the information you will need to run FSE in 
screen mode on the following terminals. 


= e CDC 722. 
e DEC VT100.t 
e Zenith Z19 or Heathkit H19.+ 
e Lear Siegler ADM38A and ADM5.t 
e Tektronix 4115.t 
Information on these terminals includes: 
e The keys equivalent to the Viking 721 editing and CDC standard keys. 
e The default settings for the programmable function keys. 


e Other miscellaneous information. 


+ The network control character (CT) for this terminal should be something 
other than ESC. The terminal uses ESC sequences for function key 
®& definitions. To change the network control character, enter: 


TRMDEF ,CT=vaLlue 


For details, refer to the NOS Reference Set, Volume 3, System Commands. 
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ANNAN 


Le 


Revisio 


& Equivalent Keys 


Viking Equivalent on 
721 Key CDC 722 Function 
FWD (F1) + Advances screen one page. 


SHIFT (F1) + (NEW LINE Moves screen backward one 
page. 

+ (NEW LINE Moves current line to top of 
screen. 


+ (NEW LINE Moves current line to 


bottom of screen. 


Es a: 
i 
uv 


+ Displays the FSE HELP 
file. 
BACK BACK directive Returns you to the 
previously edited file. 
(d) + Inserts a blank line 


allowing you to typeina 
new line of text. 


(F3) + Inserts a blank character 


over which you type the 
new character. 


a 
” 
ps) 
— 


(S) 5) Deletes the current line. 

(F3) + Deletes the current 
character. 

EOL Deletes all characters from 
the cursor to the end of the 
line. 

(a) Rewrites the entire screen. 

(HOME) Positions the cursor at the 
FSE directive line, allowing 
you to enter FSE directives. 

or Terminates an input line. 


Move cursor around on 
screen. 


2 
° 
= 
oe 
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os) 
© 
S 


Default Programmable Function Keys for 
the CDC 722 


Key Description 
F1 moves forward one page in the file. Shifted, 
F. Git F1 EX@] moves backward one page in the file. 
LINEDN Fe (QS moves the current line to the top of the screen. 
ame LINEUP Shifted, F2 [5G positions the current line to the bottom 
of the screen. 
DELC F3 BGS@ inserts a blank at the current character (you 
mom INSC can type a new character over the blank). Shifted, the 


F3 Dj3M@ key deletes the current character. You can press 
the key several times before pressing to 
perform delete or insert more than one character. It is not 


until you press that the results are shown. 


F4 inserts a blank line over which you can type 
za INSL new text. Shifted, F4 deletes the current line. You can 
press the key several times before pressing 
(NEW _LINE)to insert or delete more than one line. It is not 


until you press that the results are shown. 


UNDO F5 (2004 marks a line or lines for later use with another } 
ame MARK directive. These marked lines are not in inverse video 
display as on the Viking 721. Shifted, F5 undoes the 
previous change to your file. 
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@ Key Description 


COPY F6 Lalede§ moves any marked lines or characters to the 
emm MOVE 


current line or character. Shifted, F6 [dea copies any 
= LEFT 
. wamHELP 


marked lines or characters to the current line or character. 


F7 flalid displays the FSE HELP file. Shifted, 
F7 moves your view of the file to the left. 


RIGHT F8 (bad stops FSE without making any changes 
TommQUIT permanent. Shifted, F8 [$&al§ moves your view of the file 
to the right. 


FO GXPGY moves the cursor to the end of the current line. 


ame ENDLIN 


NOTE 
You must press or after pressing a programmable 


function key. 


Miscellaneous Information 


Do not use the key to insert tabs. Instead, use the soft tab character 
@ (the default character is \ ). 
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Seek TOPE: 
fe te ELE SSSR. 


& Equivalent Keys 


Viking Equivalent on 
721 Key DEC VT1007 


@ + (ETURN) 


(pe7) + (RETURN) 
Ve Ne aes 


A 


ji ®& § Bb 


(Fa) + (RETURN) 


P @) + (RETURN) 
BACK BACK directive 


D 


@ + (GETURN) 


(3) + (RETURN) 


2 
7) 
Pe) 
4 


(G) (GLETE) (Pra) + (RETURN) 
(FES) + (RETURN) 
) GEAR CO: RETURN) 

(ENTER): (RETURN) 


Function 
Advances screen one page. 


Moves screen backward one 


Moves current line to bottom of 
screen. 


Moves current line to top of 
screen. 


Displays the FSE HELP file. 


Returns you to the previously 
edited file. 


Inserts a blank line allowing 
you to type 1n a new line of text. 


Inserts a blank character over 
which you type the new 
character. 


Deletes the current line. 
Deletes the current character. 
Rewrites the entire screen. 


Positions the cursor at the FSE 
directive line, allowing you to 
enter FSE directives. 


Terminates an input line. 


+ All keys listed here (except (RETURN)) are located on the keypad to the right 


of the main keyboard. 
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Default Programmable Function Keys for 
the DEC VT100 


Key Description 


BKW F1 moves forward one page in the file. Shifted, 
F1 TD F1 [EX] moves backward one page in the file. 


LINEDN Fe [SQ1S02 moves the current line to the top of the screen. 
wae LINEUP Shifted, F2 [$Q]yN positions the current line to the bottom 
of the screen. 


F3 inserts a blank at the current character 
FS BiKye (you can type a new character over the blank). Shifted, 
F3 deletes the current character. You can press the 
F3 key several times before pressing to perform 
delete or insert more than one character. It is not until you 


press that the results are shown. 


F4 inserts a blank line over which you can type new 
7a INSL text. Shifted, F4 deletes the current line. You can 
press the F4 key several times before pressing to 
insert or delete more than one line. It is not until you 


press that the results are shown. 
UNDO FS M24 marks a line or lines for later use with another 
[ MEMARK 


directive. These marked lines are in inverse video display 
as on the Viking 721. Shifted, F5 ({GithYe} undoes the previous 
change to your file. 
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Key Description 


COPY F6é {lel} moves any marked lines or characters to the 
F6 (weds current line or character. Shifted, F6 (gig copies any 
marked lines or characters to the current line or character. 
HOME 
mame HELP 
CLEAR 
FS (clipes 


am ENDLIN 


NOTES 


F7 displays the FSE HELP file. Shifted, 
F7 [ila positions the cursor on the FSE directive line. 


F8 (Wad stops FSE without making any changes 
permanent. Shifted, F8 (@si§ clears your screen. 


F9 ec moves the cursor to the end of the current line. 


e You must press (RETURN) after pressing a programmable function key. 


e The unshifted function keys Fl through F9 are the keypad keys 
(1) through (9). (Within FSE, the keypad cannot be used for numeric 
values). 


e The shifted function keys are the following keypad keys. 


aw 
® 
cs 
S 
y 
S 
x 
® 
e 


Function Key 


@ Shifted F1 
Shifted F2 
Shifted F3 
Shifted F4 
Shifted F5 (-) 
Shifted F6 C) 
Shifted F7 
Shifted F8 (.) 
Shifted F9 (0) 
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Zenith 719 or Heathkit H19 


FER Rade 
Farge bles 


Equivalent Keys 
Equivalent on 
Viking Zenith Z19/ 
721 Key Heathkit H19 Function 
‘i Advances screen one page. 
+ Moves screen backward one page. 
(#3) + Moves current line to top of screen. 
- Moves current line to bottom of 
screen. 
© + Displays the FSE HELP file. 
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Equivalent on 


Zenith Z19/ 
721 Key Heathkit H19 
BACK directive 
(S) t 
t 
& f 
(Bd) t 
(S) GuEAR) ‘ 


(Home) T 


Function 


Returns you to the previously edited 
file. 


Inserts a blank line allowing you to 
type in a new line of text. When you 
insert lines, the function key 
prompts move according to the 
number of lines inserted. To align 
the prompts properly, press 

. This key does not require 
you to press afterward. 


When you press , 1t puts the 
terminal into insert mode. While 
insert mode is on, pressing any 
character moves the existing text to 
the right and inserts the new 
character. Insert mode is cancelled 
when you either press a second 


time or press (RETURN). 


Deletes the current line. When you 
delete lines, the function key 
prompts move according to the 
number of lines deleted. To align the 


prompts properly, press (RETURN). 


This key does not require you to 


press (RETURN) afterward. 


Deletes the current character. 
Rewrites the entire screen. 


Positions the cursor at the FSE 
directive line, allowing you to enter 
FSE directives. 


Terminates an input line. 


t Located on the numeric keypad to the right of the main keyboard. 
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Default Programmable Function Keys for 
the Zenith Z19/Heathkit H19 


Key 


MARK 


F1 


BKW 


meme L INEUP 


COPY 
za LINEDN 


MOVE 
ENDLIN 


F5 


em UNDO 


LEFT 
wae QUIT 


RIGHT 
meme HELP 


Description 


F1 moves forward one page in the file. Shifted, 
F1 GEG4 marks a line or lines to be used with another 
function or directive. 


F2 EX] moves backward one page in the file. Shifted, 
F2 lide] marks a character or characters for use with 
another function or directive. 


F3 (QS 2moves the current line to the top of the screen. 


F4 (QD) positions the current line to the bottom of the 
screen. Shifted, F4 [aq] copies any marked lines or 
characters to the current line or character. 


FS EXDYEQ moves the cursor to the end of the current line. 
Shifted, F5 (was moves any marked lines or characters to 
the current line or character. 


F6 (Ue} undoes the previous change to your file. 


F7 (lbag exits FSE without making changes to your file 
permanent. Shifted, F7 [aiid moves your view of the file to 
the left. 


F8 faa accesses the FSE HELP file. Shifted, 
F8 kedciaag moves your view of the file to the nght. 
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NOTES | 
You must enter after pressing a programmable function key. 


e Unshifted function keys F1 through F'5 are keyboard keys (f1)through(#5). 
Unshifted function keys F6 through F8 are the following keyboard keys. 


Function Keyboard 

Key Key 

F6 (m) (blue square) 
F7 (a) (red square) 
F8 Oo (white square) 


e Shifted function keys F1 through F8 are the shifted numbers on the 
keypad to the right of the main keyboard. For example, to enter a shifted 
F3, press: 


GarFT) @+ GETORN) 


When not shifted, keypad keys (1) through (9) allow you to move the 
cursor, insert, and delete. (The keypad cannot be used for numerals.) 


e The shifted keypad keys(0),(-), and are the shifted function 
keys F10, F11, and F12. 


Miscellaneous Information 


The Z19 hardware has tabs set every eighth column beginning with 1. These 
tabs are set at columns: 


19 17 25 33 41 49 57 65 73 


To specify tabs other than these, use the tab character (default is \ ). 
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ear Siegler ADM3A 


Equivalent Keys 
Viking Equivalent on 
721 Key Lear Siegler ADM3A Function 
FWD (Esc) + (1) + (RETURN) Advances screen one page. 
(ESC) + (SHIFT) (1) + Moves screen backward one 
(RETURN) page. 
UP (Esc) + + (RETURN Moves current line to top of 
screen. 
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Viking Equivalent on 


721 Key Lear Siegler ADM3A Function 
+(SHIFT) (2) + Moves current line to bottom 
of the screen. 
+ (7) + Displays FSE HELP file. 
BACK directive Returns you to previously 
edited file. 


(S) + (4) + Inserts a blank line allowing 


you to type in a new line of 


text. 

+ (3) + (RETURN Inserts a blank character over 
which you can type the new 
character. 

(d) + (4) + Deletes the current line. 

RETURN 
+ (3) + Deletes the current character. 
RETURN 
(<a) + (0) + (RETURN Rewrites the entire screen. 
@ Positions the cursor at the 


FSE directive line, allowing 
you to enter FSE directives. 


NEXT RETURN Terminates an input line. 
CTRL fa) Moves cursor left. 


CTRL Moves cursor down. 
CTRL (t) Moves cursor up. 


ce} BEY 


aie . 
CTRL Moves cursor right. 
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Default Programmable Function Keys for 


the Lear Siegler ADM3A 
Key Description 
F1 moves forward one page in the file. Shifted, 
aie FWD F1 EX] moves backward one page in the file. 
LINEDN Fe (alse moves the current line to the top of the screen. 
ame INEUP Shifted, F2 [$QaiyX] moves the current line to the bottom of 
the screen. 


F3 inserts a blank at the current character 

INSC (you can type a new character over the blank). Shifted, 

F3 deletes the current character. You can press F3 
several times before pressing to delete or insert 
more than one character. It is not until you press 


that the results are shown. 


F4 inserts a blank line over which you can type new 
INSL text. Shifted, F4 deletes the current line. You can 

press the F4 key several times to insert or delete more than 
one line. It is not until you press that the results 


are shown. 
UNDO F5 G2G04 marks a line or lines for later use with another 
FS Whit function. Shifted, F5 [XP] undoes previous changes to 


your file. 


COPY F6 fieY4 moves any marked lines or characters to the 
F6 Leds current line or character. Shifted, F6 (jig copies any 
marked lines or characters to the current line or character. 


LEFT F7 fila@ accesses the FSE HELP file. Shifted, 
wameHELP F7 [94g moves your view of the file to the left. 
RIGHT F8 Gbad exits FSE without making changes to your file 
F8 (lUbay permanent. Shifted, F8 8&al§ moves your view of the file 
to the right. 
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NOTES 
e You must press after pressing a programmable function key. 


e Function keys F1 through F15 are the top row of keyboard keys 
(1)through(*). Each must be preceded by . For example, to enter an 


F3, press: 
+@+ 


To use the shifted functions of these keys, include the key. 


(ESC) + (SHIFT) (3) + (RETURN) 


e and (0) perform the same function, so in effect there is no 
shifted F10 function. 


Miscellaneous Information 


To specify tabs, use the soft tab character (the default character is \). 
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Lear Siegler ADM5 


Equivalent Keys 
Viking Equivalent on 
721 Key Lear Siegler ADM5 Function 
+ (1) + Advances screen one page. 
(ESC) + (1) + Moves screen backward one 
page 
+ (2) + Moves current line to top of 
screen. 
+ (2)+ Moves current line to bottom 
of the screen. 
+ + Displays FSE HELP file. 
BACK directive Returns you to previously 
edited file. 


g 


+(4)+ Inserts a blank line allowing 
you to type in a new line of 
text. 


+ (3) + (RETURN Inserts a blank character over 
which you can type the new 
character. 

(d) +(SHIFT) (4) + Deletes the current line. 

RETURN 
+ (3) + Deletes the current character. 
RETURN 

(Sd) (PAGE)+ Rewrites the entire screen. 

Clears a line from the current 
character to the end of the line. 

Positions the cursor at the 
FSE directive line, allowing 
you to enter FSE directives. © 

RETURN Terminates an input line. 
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Default Programmable Function Keys for 


the Lear Siegler ADM5 | 
Key Description 
F1 moves forward one page in the file. Shifted, 
F1 F1 EX@] moves backward one page in the file. 
LINEDN Fo [eases moves the current line to the top of the screen. 
ame L LINEUP Shifted, F2 [S@7] moves the current line to the bottom of 
the screen. 
DELC F3 bXXN@ inserts a blank at the current character 
ome LNSC (you can type a new character over the blank). Shifted, 


F3 bJa@q deletes the current character. You can press F3 
several times before pressing to delete or insert 


more than one character. It is not until you press(RETURN) 
that the results are shown. 


F4 inserts a blank line over which you can type new 
text. Shifted, F4 deletes the current line. You can 

press the F4 key several times to insert or:delete more than 
one line. It is not until you press that the results 


are shown. 


DELL 
INSL 


UNDO 


F5 GLEE marks a line or lines for later use with another 
function. Shifted, F5 [J undoes previous changes to 
your file. 


= 


F6 Wea moves any marked lines or characters to the 
current line or character. Shifted, F6 [deg copies any 
marked lines or characters to the current line or character. 


F6 


F7 accesses the FSE HELP file. Shifted, 


F7 F7 (aad moves your view of the file to the left. 


F8 (bag exits FSE without making changes to your file 
permanent. Shifted, F8 Ggdidig moves your view of the file 
to the night. 


2 A = i a 

cre mim 22 
Mm @ rw <_ Uv 
acer vT-4 m ~< 


F8 


Revision B Terminal Support Information D-19 e 


NOTES 


e You must press (RETURN) after pressing a programmable function key. 


e Function keys F1 through F14 are the top row of keyboard keys 
(1)through(). Each must be preceded by (ESC) . For example, to enter an 
F3, press: 


0): @): 
To use the shifted functions of these keys, include the key. 


(ES0)+ GIFT) @)+ RETURN 


e (0)and (0) perform the same function, so in effect there is no 
shifted F10 function. 


Miscellaneous Information 


To specify tabs, use the soft tab character (the default character is \). Do not 
use the key. 
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@ Tektronix 4115 


D-21 e 


Terminal Support Information 


B 


1810n 


Rev 


Equivalent Keys 


Viking Equivalent on 
Tektronix 4115 


(F1) 
(SHIFT) (F1) 
(F2) 


(SHIFT) (FA) 


BACK BACK directive 


INSAT CA © 


({RTN 


(era) (7) 


Q 
6 


(era) (+) 


=e 
a0 ({) 
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Function 
Advances screen one page. 
Moves screen backward one page. 


Moves current line to top of the 
screen. 


Moves current line to bottom of the 
screen. 


Displays FSE HELP file. 
Returns you to previously edited file. 


Places the terminal in a mode in 
which pressing any character key 
moves existing text to the nght and 
inserts the new character. This mode 


is cancelled by pressing (RTN). 


Inserts a blank line allowing you to 
type in a new line of text. 


Deletes the current line. 
Deletes the current character. 
Rewrites the entire screen. 


Positions the cursor at the FSE 
directive line, allowing you to enter 
FSE directives. 


Terminates an input line. 


Moves cursor left. 
Moves cursor down. 
Moves cursor up. 


Moves cursor night. 
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@ Default Programmable Function Keys for 


the Tektronix 4115 
Key Description 

é BKW F1 moves forward one page in the file. Shifted, 
F1 F1 XQ) ~moves backward one page in the file. 


Fe [aad moves the current line to the top of the screen. 
Shifted, F2 [BQH] moves the current line to the bottom of 
the screen. 


F2 


F3 Gassad moves the cursor to the first line in the file. 
ee FIRST Shifted, F3 [Sag moves the cursor to the last line in the 
file. 


F4 Wife} cancels any marks you have set. If no marks 
were set, F4 Uilde} cancels the most recent change to your 
file during the current editing session. 


F4 


FS QEG%4 marks a line for later use with another 
‘ie MARK function. Shifted, F5 Giit@ealid] marks a character or 
characters for use with another function. 


F6 fie moves any marked lines or characters to the 
& F6 current line or character. Shifted, F6 [ded@ copies any 
marked lines or characters to the current line or character. 


x 2s = Cc [— ial 86 
ome) wD z= > m Ses 
< U yas o 7) z2Z2nho 
m-~< ‘2 © 4 mim 
x co 
ro) v2 


F7 (Was exits FSE without making the changes to your 
file permanent. Shifted, F7 (4M2N3} clears your screen. 


F7 


HELP F8 [ey positions the cursor on the FSE directive 
F8 els line. Shifted, F8 displays the FSE HELP file on the 
lower half of your screen. 
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NOTES 


e Unshifted function keys F9 through F12 are the following keyboard keys. 


e The shifted function keys F9 through F12 are the following keyboard 


Function Keyboard 
Key Key 

F9 CRD @) 
F10 CAD © 
Ful CTRL) ©) 
Fi2 Cray ©) 
keys. 

Function Keyboard 
Key Key 
Shifted F9 @) 
Shifted F10 (Ww) 
Shifted F11 (E) 
Shifted F12 (R) 
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Revision B 


Function Key Directive Strings E 
This appendix contains the directive strings associated with the default 
settings of the programmable function keys. 
The directive strings used by FSE are: 
Stringt Key Prompt 
SKn/VNS/LABEL/FWD/ FWD 
SKn/VPS/LABEL/BKW/ BKW 
SKn/VN/LABEL/UP/ UP 
SKn/VP/LABEL/DOWN/ DOWN 
SKn/.I/LABEL/INSC/ INSC 
SKn/.D/LABEL/DELC/ DELC 
SKn/IBP1/LABEL/INSL/ INSL 
SKn/D;PN/LABEL/DELL/ DELL 
SKn/.END/LABEL/ENDLIN/ ENDLIN 
SKn/SM/LABEL/MARK/ MARK 
SKn/VH/LABEL/HOME/ HOME 
SKn/SS/LABEL/CLEAR/ CLEAR 
SKn/CMTP/LABEL/COPY/ COPY 
SKn/MMTP/LABEL/MOVE/ MOVE 
SKn/UNDO/LABEL/UNDO/ UNDO 
SKn/QUIT/LABEL/QUIT/ QUIT 
SKn/HELP/LABEL/HELP/ HELP 
SKn/ /LABEL/ / 
SKn/SVO0/LABEL/LEFT/ LEFT 
SKn/SVO&&C;.P+20/ LABEL/ RIGHT RIGHT 
SKn/PF/LABEL/FIRST/ FIRST 
SKn/VL/LABEL/LAST/ LAST 
SKn/IBP/LABEL/INSB/ INSB 
SKn/DB/LABEL/DELB/ DELB 
SKn/SVC80/LABEL/80COL/ 80COL 
SKn/SVC132/LABEL/132COL/ 132COL 
SKn”?L/&&?/” LABEL” LOCATE” LOCATE 
@ +n can be any number from 1 through 16. 
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Stringt Key Prompt 


SKn/LN/LABEL/LOCNXT/ LOCNXT 
SKn/V/LABEL/ MIDDLE/ MIDDLE 
SKn/SMW/ LABEL/MRKCHR/ MRKCHR 
SKn/.S/LABEL/SPLIT/ SPLIT 
SKn/.J/LABEL/JOIN/ JOIN 
SKn/.F/LABEL/PARA/ PARA 
SKn/.C/LABEL/CENTER/ CENTER 


SKn/SVC80;SVL34/LABEL/80COL/ 80COL 
SKn/SVC160;SVL64/LABEL/160COL/ = 160COL 


Viking 721 Directive String Settings 


The directive strings associated with the default settings for the Viking 721 
terminal are: 


String Key Prompt 
SK1/SM/LABEL/MARK/ MARK 
SKS1/SMW/LABEL/MRKCHR MRKCHR 
SK2/MMTP/LABEL/MOVE/ MOVE 
SKS2/CMTP/LABEL/COPY/ COPY 
SK3/IBP/LABEL/INSB/ INSB 
SKS3/DB/LABEL/DELB/ DELB 
SK4/PF/LABEL/FIRST/ FIRST 
SKS4/VL/LABEL/LAST/ LAST 
SK5/UNDO/LABEL/UNDO/ UNDO 
SK6/QUIT/LABEL/QUIT/ QUIT 
SK7/"L/&&?/” LABEL” LOCATE” LOCATE 
SKS7/LN/LABEL/LOCNXT/Y/ LOCNXT 
SK8/SVC132/LABEL/132COL/ 1382COL 
SKS8/SVC80/LABEL/80COL/ 80COL 
SK9/V/LABEL/ MIDDLE/ MIDDLE 
SK10/.END/LABEL/ENDLIN/ ENDLIN 
SK11/.S/LABEL/SPLIT/ SPLIT 
SK12/.J/LABEL/JOIN/ JOIN 
SK13/.F/LABEL/PARA/ PARA 
SK14/CMTP/LABEL/COPY/ COPY 
SK15/.C/LABEL/CENTER/ CENTER 
+n can be any number from 1 through 16. & 
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CDC 722 Directive String Settings 


The directive strings associated with the default settings for the CDC 722 


terminal are: 
String 


SK1/VNS/LABEL/FWD/ 
SK2/VN/LABEL/LINEUP/ 
SK3/.1/LABEL/INSC/ 
SK4/IBP1/LABEL/INSL/ 
SK5/SM/LABEL/MARK/ 
SK6/MMTP/LABEL/MOVE/ 
SK7/HELP/LABEL/HELP/ 
SK8/QUIT/LABEL/QUIT/Y 
SK9/.E/LABEL/ENDLIN/ 


SKS1/VPS/LABEL/BKW/ 
SKS2/VP/LABEL/LINEDN/ 
SKS3/.D/LABEL/DELC/ 
SKS4/D;PN/LABEL/DELL/ 


SKS5/UNDO/LABEL/UNDO/ 


SKS6/CMTP/LABEL/COPY/ 
SKS7/SVO00/LABEL/LEFT/ 


SKS8/SVO&C;.P+20/ LABEL/RIGHT/ 
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Key Prompt 


FWD 
LINEUP 
INSC 
INSL 
MARK 
MOVE 
HELP 
QUIT 
ENDLIN 


BKW 
LINEDN 
DELC 
DELL 
UNDO 
COPY 
LEFT 
RIGHT 


Function Key Directive Strings 


E-3 


DEC VT100 Directive String Settings 


String 


SK 

SK1/VNS/LABEL/FWD/ 
SK2/VN/LABEL/LINEUP/ 
SK3/.I/LABEL/INSC/ 
SK4/IBP1/LABEL/INSL/ 
SK5/SM/LABEL/MARK/ 
SK6/MMTP/LABEL/MOVE/ 
SK7/HELP/LABEL/HELP/ 
SK8/QUIT/LABEL/QUIT/ 


SK9/.END/LABEL/ENDLIN/ 
SKS1/VPS/LABEL/BKW/ 
SKS2/VP/LABEL/LINEDN/ 
SKS3/.D/LABEL/DELC/ 
SKS4/D;PN/LABEL/DELL/ 
SKS5/UNDO/LABEL/UNDO/ 
SKS6/CMTP/LABEL/COPY/ 
SKS7/VH/LABEL/HOME/ 
SKS8/SS/LABEL/CLEAR/ 
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Key Prompt 


Clears all the keys 
FWD 

LINEUP 

INSC 

INSL 

MARK 

MOVE 

HELP 

QUIT 


ENDLIN 
BKW 
LINEDN 
DELC 
DELL 
UNDO 
COPY 
HOME 
CLEAR 
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Zenith Z19 and Heathkit H19 Directive 


String Settings 


String 


Key Prompt 


SK 

SK1/VNS/LABEL/FWD/ 
SK2/VPS/LABEL/BKW/ 
SK3/VN/LABEL/LINEUP/ 
SK4/VP/LABEL/LINEDN/ 
SK5/.END/LABEL/ENDLIN/ 
SK6/UNDO/LABEL/UNDO/ 
SK7/QUIT/LABEL/QUIT/Y 


SK8/HELP/LABEL/HELP/ 
SKS1/SM/LABEL/MARK/ 
SKS2/SMW/LABEL/MRKCHR/ 
SKS4/CMTP/LABEL/COPY/ 
SKS5/MMTP/LABEL/MOVE/ 
SKS7/SVO0/LABEL/LEFT/ 
SKS8/SVO&C;.P+20/ LABEL/ RIGHT/ 
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Clears all the keys 
FWD 

BKW 

LINEUP 
LINEDN 
ENDLIN 

UNDO 

QUIT 


HELP 
MARK 
MRKCHR 
COPY 
MOVE 
LEFT 
RIGHT 


Function Key Directive Strings 


E-5 


Lear Siegler ADM3A Directive String 


Settings 


String 


SK1/VNS/LABEL/FWD/ 
SK2/VN/LABEL/LINEUP/ 
SK3/.1/LABEL/INSC/ 
SK4/IBP1/LABEL/INSL/ 
SK5/SM/LABEL/MARK/ 
SK6/MMTP/LABEL/MOVE/ 
SK7/HELP/LABEL/HELP/ 


SK8/QUIT/LABEL/QUIT/Y 
SK9/.END/LABEL/ENDLIN/ 
SK10/SS/LABEL/CLEAR/ 
SK11/PF/LABEL/FIRST/ 
SK12/TBP/LABEL/INSB/ 
SK13”L/&?/” LABEL” LOCATE” 
SK14/.S/LABEL/SPLIT/ 
SK15/.F/ LABEL/PARA/ 


SKS1/VPS/LABEL/BKW/ 
SKS2/VP/LABEL/LINEDN/ 
SKS3/.D/LABEL/DELC/ 
SKS4/D;PN/LABEL/DELL/ 
SKS5/UNDO/LABEL/UNDO/ 
SKS6/CMTP/LABEL/COPY/ 
SKS7/SVO0/LABEL/LEFT/ 


SKS8/SVO&C;.P+20/ LABEL/RIGHT/ 


SKS9/SMW/LABEL/MRKCHR/ 
SKS11/VL/LABEL/LAST/ 
SKS12/DB/LABEL/DELB/ 
SKS13/LN/LABEL/LOCNXT/ 
SKS14/.J/LABEL/JOIN/ 
SKS15/.C/LABEL/CENTER/ 
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Key Prompt 


FWD 
LINEUP 
INSC 
INSL 
MARK 
MOVE 
HELP 


QUIT 
ENDLIN 
CLEAR 
FIRST 
INSB 
LOCATE 
SPLIT 
PARA 


BKW 
LINEDN 
DELC 
DELL 
UNDO 
COPY 
LEFT 


RIGHT 


MRKCHR 


LAST 
DELB 
LOCNXT 
JOIN 
CENTER 
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Lear Siegler ADM5 Directive String 


Settings 


String 


SK1/VNS/LABEL/FWD/ 
SK2/VN/LABEL/LINEUP/ 
SK3/.1/LABEL/INSC/ 
SK4/IBP1/LABEL/INSL/ 
SK5/SM/LABEL/MARK/ 
SK6/MMTP/LABEL/MOVE/ 
SK7/HELP/LABEL/HELP/ 


SK8/QUIT/ LABEL/QUIT/ 
SK9/.END/LABEL/ENDLIN/ 
SK10/SS/ LABEL/CLEAR/ 
SK11/PF/LABEL/FIRST/ 
SK12/IBP/LABEL/INSB/ 
SK137L/&?/” LABEL” LOCATE” 
SK14/.S/LABEL/SPLIT/ 


SKS1/VPS/LABEL/BKW/ 
SKS2/VP/LABEL/LINEDN/ 
SKS3/.D/LABEL/DELC/ 
SKS4/D;PN/LABEL/DELL/ 
SKS5/UNDO/LABEL/UNDO/ 
SKS6/CMTP/LABEL/COPY/ 
SKS7/SVO00/LABEL/ LEFT/ 


SKS8/SVO&C;.P+20/ LABEL/RIGHT/ 
SKS9/SMW/LABEL/MRKCHR/ 
SKS11/VL/LABEL/LAST/ 
SKS12/DB/LABEL/DELB/ 
SKS138/LN/LABEL/LOCNXT/Y 
SKS14/.J/LABEL/JOIN/ 
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Key Prompt 


FWD 
LINEUP 
INSC 
INSL 
MARK 
MOVE 
HELP 


QUIT 
ENDLIN 
CLEAR 
FIRST 
INSB 
LOCATE 
SPLIT 


BKW 
LINEDN 
DELC 
DELL 
UNDO 
COPY 
LEFT 


RIGHT 
MRKCHR 
LAST 
DELB 
LOCNXT 
JOIN 


Function Key Directive Strings 
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Tektronix 4115 Directive String Settings @ 


String Key Prompt 
SK1/VNS/LABEL/FWD/ FWD 
SK2/VN/LABEL/LINEUP/ LINEUP 
SK3/PF/LABEL/FIRST/ FIRST @ 
SK4/UNDO/LABEL/UNDO/ UNDO 
SK5/SM/LABEL/MARK/ MARK 
SK6/MMTP/LABEL/MOVE/ MOVE 
SK7/QUIT/LABEL/QUIT/ QUIT 
SK8/VH/LABEL/HOME/ HOME 
SK9/SVC160:SVL64/LABEL/160COL/ —_160COL 
SK10"L/&?/” LABEL” LOCATE” LOCATE 
SK11/.END/LABEL/ENDLIN/ ENDLIN 
SK12/.S/LABEL/SPLIT/ SPLIT 
SKS1/VPS/LABEL/BKW/ BKW 
SKS2/VP/LABEL/LINEDN/ LINEDN 
SKS3/VL/LABEL/LAST/ LAST 
SKS5/SMW/LABEL/MRKCHR/ MRKCHR 
SKS6/CMTP/LABEL/COPY/ COPY 
SKS7/SS/LABEL/CLEAR/ CLEAR 
SKS8/HELP/LABEL/HELP/ HELP 
SKS9/SVC80:SVL34/LABEL/80COL/ — 80COL 
SKS10/LN/LABEL/LOCNXT/ LOCNXT 
SKS11/.F/LABEL/PARA/ PARA 
SKS12/.J/LABEL/JOIN/ JOIN 


e E-8 FSE User’s Guide Revision B 


Viking 721 Terminal Settings F 


The Viking 721 terminal contains software setup switches, which should be 
set as shown here to ensure correct operation under FSE. These switches are 
software toggle switches. That is, you have a limited number of options 
(usually two) from which to choose. To change a switch setting, press the 
corresponding programmable function key. The first set of switches appears 
when you turn on your terminal. Set them as follows: 


[a MODE 1M MODE 2MMODE 3BMODE 4D MODE SIE MODE 6 fa MODE 7 Ma TRMNL 
Wm CYBER Pa PLATO BM CP/M BA DISK [94014 PACK Bey TEST 
Once you have set these as shown, press: 
F Ca 
CYBER - 


to select CYBER mode. At this point, the screen becomes blank except for the 
cursor. 


Press: 


to display the next set of switches and change them, if necessary, to the 
following settings. 


a Return [ge LINE [ig PRNTR [ad MARGINGR ALERT BaLOCK MN PAD [ESSCREEN MCYBER [mm MORE 

1 Pa ON Ika OFF EON [BS SOFT [@RALPHABANORMAL Bel ROLL [CRLARGE MIO) SELECT 
Then, press: 

aa MORE 

ae) SELECT 
to set the next set of switches to the following. 

fl return ig BACKGD fm CURSOR [Gm CURSOR [ig BAUD Mm DUPLEX Mig CHR/LN [ig LINES [id XPARNT [al mode 

1 PA DARK PBEBLOCK FMSOLID BY 1200—m HALF fd 80 [EY 30 Fe) ore (RI SeLect 
When you have set all the switches, press: 


; 
cor 


to remove the switch prompts from the screen. You are now ready to log in to 


NOS. 


Refer to the 721-10: 20/30 Hardware Reference Manual for further 
information on these settings (ordering information is in the preface). 
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Index 


Index 


A 


About this manual 3 

Advanced functions 6-1 

ALTER directive 4-9; 7-7 

Arrow keys 2-8 

Attempting to display too many 
lines 7-3 


B 


BACK directive 4-12 
BACK key 2-17,25; 4-58; 5-7 
BACKSPACE key 2-24 
BACKTAB key 2-24 
BASIC 2-21 

BKW key 2-13,25 


C 


Calling a procedure from a file 6-5 
CDC standard function keys 2-25 
CDC 722 terminal 1-2; D-2 
CENTER 2-29; 5-12 
Centering lines 4-63; 5-12 
Changing 

Current file name 4-50 

Lines 4-9; 7-7 

Screen format 4-55; 6-23 
Changing screen format 5-13 
Character 

Deletion 2-9; 4-63 

Insertion 2-9; 4-64 
Character sets 3-1 
CLEAR key 2-24 
Code Set Conversion Chart A-1l 
Column alignment 4-24 
Combining directives 4-3 
Command 

FSE 2-2,7; 3-1; 5-2 

SCREEN 2-1,6 
COMMENT (--) directive 4-69 
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Common parameters 4-5 
Direction 4-5 
(File) 4-5 
Line 4-6 
Range 4-8 
String 4-8 
Communication errors B-1 
Conditional Procedures 6-13 
Parameters 6-14 
Using line addresses 6-13 
Using QP 6-14 
COPY 2-15,27,29 
COPY directive 4-13; 7-8 
COPY key 2-15; 5-7 
Copying 
Lines 2-15; 4-138; 7-8 
Lines between files 5-3 
Text 4-13 
Creating FSE procedures 6-4 
Creating Multifile files 2-20 
Creating Multirecord files 2-20 
Cursor 2-5 
Cursor positioning 2-8; 4-38 


D 


DASH (-) directive 4-65 
DEC VT100 terminal 1-2; D-6 
Default function key settings 8-4 
Defining keys to call 
procedures 6-18 
DELB 2-27 
DELETE directive 4-15 
DELETE directive 7-6 
Deleting 
Characters 2-9; 4-63 
Lines 2-11; 4-15; 7-6 
Words 4-18 
Diagnostic messages B-1 
Directive 
Abbreviations 4-1 
Description conventions 4-4 
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Format 
ALTER 4-10 
BACK 4-12 
COPY 4-13 
DELETE 4-15 
FSE 4-20 
GET 4-22 
HELP 4-25 
INSERT 4-28,29 
LOCATE 4-30 
MOVE 4-36 
PRINT 4-38 
QUIT 4-40 
REPLACE 4-43 
SET 4-50 
TEACH 4-58 
UNDO 4-60 
VIEW 4-61 
DOT 4-63 
DASH _ 4-65 
COMMENT 4-69 
SLASH 4-70 
FSE 2-7; 5-2 
Line 2-5 
Parameters 4-5 
Syntax 4-1 
Directives, entering 2-30 
Displaying lines 7-3 
DLETE key 2-9,11,24 
DOWN key 2-25 


E 


Editing 
Different parts of same file 6-3 
Keys 2-23,24 
Line mode 7-1 
Screen 2-1 
Screen editing 2-6 
Sequenced files 2-21; 7-9 
Session 2-6 
Split-screen 5-3; 6-2 
Text 2-8 
Two files at same time 6-2 
ENDLIN 2-28 
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Entering directives 2-30 
Equivalent keys 1-5; 8-1; D-1 
ERASE key 2-24 
Error 

Messages B-3 

Recovery B-1 


F 


File 
FSEPROC 6-4 
Header 2-5 
Text 2-5 
File marks 2-20 
FIRST 2-27 
FORTRAN 2-21 
FSE 
Advanced functions 6-1 
Capabilities 1-1 
Command 2-5,7,18,20; 3-1; 
5-2,14; 7-9 
Command parameters 3-1 
Directive 4-20; 5-3; 6-2 
Directives 4-1 
Help 2-17 
Introduction 1-1 
Procedures 
Branching 6-20 
Calling 4-65 
Comments 4-69 
Creating 6-4 
Errors 6-15 
Format 4-66; 6-4 
Micros 4-67 
Prompts 4-50; 6-6 
STARTUP 6-4,18 
Stopping 4-40 
Restarting 2-18; 5-14; 7-9 
Starting 2-7; 5-2; 7-1 
Status 4-22 
Stopping 2-18; 4-40; 5-14; 7-9 
FSEPROC file 6-4 
Function key 
Directive strings E-1 
Prompts 2-5; 4-51 
Function key definition 6-17 
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Function key prompts 5-9 
Setting key prompts 5-9 

Function keys 2-23 

Functions, advanced 6-1 

FWD key 2-12.25 

Fl key 2-14,27; 5-4,5 

F2 key 2-15,27 

F3 key 2-27; 5-10 

F4 key 2-27 

F5 key 2-16,28 

F6 key 2-18,28 

F7 key 2-28 

F8 key 2-28 

F9 key 2-26,28 

Fl0 key 2-28 

F1l key 2-28 

F12 key 2-28 

F13 key 2-29; 5-11 

F14 key 2-29 

F15 key 2-29; 5-12 

F16 key 2-29 


G 


GET directive 4-22 
Getting started 2-1 
Glossary C-1l 


H 


Heathkit H19 terminal 1-2; D-10 
Help 7-6 

HELP directive 4-25; 7-6 

HELP file 4-19,26 

HELP key 2-17,25 

HOME key 2-18,30 


INSB 2-27; 5-10 
INSERT directive 4-28; 7-5 
Inserting 
Characters 2-9; 4-64 
Lines 2-10; 7-5 
Paragraphs 5-10 
Text 4-28 
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INSRT key 2-9,10,24 
Interactive procedure input 6-10 
Internal messages B-8 
Introduction 1-1 


J 


Job recovery B-2 

JOIN 2-28 

Joining lines 4-64 
Justifying paragraphs 5-11 


K 


Keys 1-4 
CDC standard function 2-25 
Editing 2-24 
Programmable function 2-26; 
o-9 


L 


Labeling function keys 6-19 
LAST 2-27 


Lear Siegler ADM38A terminal 1-2; 


D-14 
Lear Siegler ADM5 terminal 1-2; 
D-18 
Leaving FSE 4-40 
Line 
Centering 4-63; 5-12 
Changing 7-7 
Copying 2-15; 7-8 
Deletion 2-11; 7-6 
Insertion 2-10; 4-28; 7-5 
Joining 4-64 
Marking 2-14 
Moving 2-14 
Pointers 4-57 
Printing 4-61 
Replacing 7-8 
Splitting 4-64 
LINE command 7-1 
Line editing 7-1 
Line mode, setting 4-52 
Line number increment 4-50 
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LOCATE 2-28 

LOCATE directive 4-30; 7-4 
Locating text 4-30 
LOCNXT 2-26,28 


M 


Making changes permanent 2-18; 


7-9 
Manual 
Conventions 3 
Organization 5 
Related publications 6 
Margins 4-57 
MARK 2-14,27; 5-4,5 
Marking lines 2-14 
Message area 2-5 
Messages diagnostic B-3 
Internal B-8 
User B-3 
Micros 6-7 
Expansion of micros during 
procedure execution 6-11 
Micro values 6-11 
&C 6-7 
&F 6-8 
&L 6-8 
&n 6-10 
&T 6-9 
&W 6-9 
&? 6-10 
MIDDLE 2-28 
Misspelled directives 4-3 
Modification characters 4-9 
MOVE 2-15,27 
MOVE directive 4-36 
Moving lines 2-15; 4-36 
MRKCHR 2-26,27 


N 


Network control character D-1 
NEXT key 2-25 
NOS 

Commands 4-70 

Recovery B-2 
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NOS line command 3-3 
NOS screen command 3-3 


O 


Online help 2-17; 4-25; 7-6 
Other terminals 1-5 


P 


Paging 
Backward 2-12 
Forward 2-12 
PARA 2-29; 5-11 
Paragraph 
Insertion 5-10 
Justification 4-63; 5-11 
Parameter order 4-2 
Permanent changes 2-18; 5-16 
Pointers 4-57 
Positioning the cursor 2-8; 4-38 
Preface 3 
PRINT directive 7-3 
Printing lines 4-61; 7-3 
Printing text 4-38 
Procedure 
Branching 6-20 
Calling 4-65 
Comments 4-69 
Creating 6-4 
Error recovery 6-15 
Format 6-4 
Micros 4-67 
Prompts 4-50; 6-6 
STARTUP 6-4,18 
Stopping 4-40 
Procedures 
Procedure looping 6-12 


Recursive procedure calls 6-12 
Programmable function keys 2-26; 


4-50 

Default settings 8-4; D-1 
Labeling 6-19 

Prompts 2-5; 4-51; 6-19 
Redefining 6-17 
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QR 2-18 

QUIT 2-18,28 

QUIT directive 4-40,70; 7-9 
QUIT PROC 6-4 
QUIT REPLACE 2-18; 5-16 


R 


Recovering jobs B-2 
Recovery 
From losing your 
connection B-2 
Procedures B-1,2 


Redefining function keys 4-50; 6-17 


Related publications 6 
REPLACE directive 4-43; 7-8 
Replacing 

Files 2-18 

Lines 4-43 

Text 4-43; 7-8 

Words 4-43 
Restarting FSE 2-18; 5-15; 7-9 


S 


Sample display screen 2-4 
Sample screen editing session 5-1 
Screen 

Editing 2-1 

Format 2-5 

Mode 2-6 
SCREEN command 2-1,6 
Screen editing sample session 5-1 
Screen format 5-13; 6-23 
Searching 4-30; 7-4 
Sequence numbers 4-53 
Sequenced files 2-21; 4-50,53; 7-9 
SET ANNOUNCE directive 6-6 
SET directive 4-50 

ANNOUNCE 4-50 

CHAR 4-50 

FILENAME 4-50 

INCREMENT 4-50 

KEY 4-51; 6-17 
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LINE 4-52 
MARK 4-52 
NUMBER 4-538 
BASIC 4-54 
FORTRAN 4-54 
PROMPT 4-53 
SCREEN 4-54 
SPLIT 6-24 
TAB 4-54 
UNDO 4-55 
VIEW 4-55 
COLUMN 6-23 
EDIT 6-24 
LINE 6-23 
OFFSET 6-24 
WARN 6-24 
WORD FILL 4-57 
X 4-57 
Y 4-57 
Z 4-57 
Setting 
Line mode 4-52; 7-1 
Margins 4-57 
Marks 4-52 
Screen Mode 2-6 
Tabs 4-54 
SETUP key F-1 
SLASH (/) directive 4-70 
Soft tab character 4-50 
Specifying 
Another edit file 4-20 
Columns to be edited 6-24 
Current column 6-7 
Current file 6-8 
Current line 6-8 
Current terminal type 6-9 
Current word 6-9 
Interactive input 6-10 
Left screen margin 6-24 
Line length 6-24 
Nth parameter 6-10 
Number of columns 
displayed 6-23 
Number of lines displayed 6-23 
Number of lines for split-screen 
editing 6-24 
Screen format 4-55 
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SPLIT 2-28 
Split screen 4-20 
Split-screen editing 5-3; 6-2 
Splitting lines 4-64 
Standard function keys 2-25 
Starting FSE 2-7; 5-2; 7-2 
STARTUP procedure 6-4,18 
STOP key 2-25 
Stopping FSE. 5-14; 7-9 
String delimiters 4-2 
System-defined terminals 
CDC 722 1-2 
DEC VT100 1-2 
Heathkit H19 1-2 
Lear Siegler ADM38A 1-2 
Lear Siegler ADM5 1-2 
Tektronix 4115 1-2 
Viking 721 1-2 
Zenith Z19 1-2 


T 


Tab character 4-50 
TAB key 2-24 
TEACH directive 4-58 
Tektronix 4115 terminal 1-2; D-21 
Terminal 
CDC 722 D-1 
Default function key 
settings D-4 
Directive string settings E-3 
Configuration F-1 
DEC VT100 D-1 
Default function key 
settings D-8 
Directive string settings E-4 
Equivalent Viking 721 and CDC 
722 keys D-3 
Equivalent Viking 721 and DEC 
VT100 keys D-7 
Equivalent Viking 721 and 
Heathkit H19 keys D-10 
Equivalent Viking 721 and Lear 
Siegler ADM3A keys D-14 
Equivalent Viking 721 and Lear 
Siegler ADM5 keys D-18 
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Equivalent Viking 721 and 
Tektronix 4115 keys D-22 
Equivalent Viking 721 and 
Zenith Z19 keys D-10 
Function keys 2-23 
Heathkit H19 D-1 
Default function key 
settings D-12 
Directive string settings E-5 
Lear Siegler ADM3A_ D-1 
Default function key 
settings D-16 
Directive string settings E-6 
Lear Siegler ADM5 D-1 
Default function key 
settings D-19 
Directive string settings E-7 
Support information D-1 
Tektronix 4115 D-1 
Default function key 
settings D-23 
Directive string settings E-8 
Viking 721 
CYBER mode F-1 
Directive string settings E-2 
Hardware configuration F-1 
Keys 1-4 
Setup settings F-1 
Zenith Z19 D-1 
Default function key 
settings D-12 
Directive string settings E-5 
Terminal Definitien Utility 2-2 
Text editing 2-8 
Tutorial file 4-58 
Typing over text 2-8 


U 


UNDO 2-16,28 

UNDO directive 4-60; 7-8 
Undoing changes 2-16; 4-60; 7-8 
UP key 2-25 

User messages B-3 

Using other terminals 8-1 
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. 
VIEW directive 4-61; 7-4 
Viking 721 terminal 1-3 


Viking 721 terminal keys 1-4 
Ww 


What you need to know about this 
manual 3 
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Word processing 4-63; 5-8 
Worksheet 
Procedure branching 6-21 
Using other terminals 8-3 


Zenith Z19 terminal 1-2; D-10 
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We would hke your comments on this manual. While writing it, we made some assumptions about who would use it 
and how it would be used. Your comments will help us improve this manual. Please take a few minutes to reply. 


Who Are You? How Do You Use This Manual? 


() Manager CJ] As an Overview 

(] Systems Analyst or Programmer C) To Learn the Product/System 
[J] Applications Programmer C) For Comprehensive Reference 
(] Operator () For Quick Look-up 


CL] Other ___. =. 


What programming languages do you use? __. 


Do You Also Have? 


CO NOS 2 Reference Set, Vol 1 
[] NOS 2 Reference Set, Vol 2 
(] NOS 2 Reference Set, Vol 3 


O 
C] Other, — Dae ae 


Which are helpful to you? CJ Directive Index 


CL) Character Set 


Common Parameter Index 


(J Diagnostics (App B) 


How Do You Like This Manual? Check those that apply. 


Is it easy to understand? 


Is the order of topics logical? 


Are there enough examples? 


Are the examples helpful? (CJ Too simple 


Is the technical! information accurate? 


Can you easily find what you want? 


Do the illustrations help you? 


Comments? If applicable, note page number and paragraph. 


Would you like a reply? <> Yes 1 No 


From: 


Name _.. Company 


Address _ 


Please send program listing and output if applicable to your comment. 


Is the manual easy to read (print size, page layout, and so on)? 


C) Too complex) 


Does the manual tell you what you need to know about the topic? 
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